Differences between revisions 3 and 9 (spanning 6 versions)

Version reference tables

OTRgate - the transition between 3.2, 3.2.1 and 3.2.2

Since the switch to libotr4 overlapped with the fixes for twitter (which is the main reason 3.2.1 was released), and additionally debian released their own version with a name that's suspiciously similar to 3.2.1, here's a table that documents all the relevant versions to both OTR and Twitter support.

Releases only

Date	bzr	Release	libotr	Twitter?	Stable?	Notes	Where to get
2013-01-06	965	3.2 ¹	3	No	Yes	The original 3.2 release. Old but stable.	bzr, Release .tar.gz
2013-11-27	999	3.2.1²	3	Yes	Yes	Official 3.2.1 release	bzr, Release .tar.gz
2013-12-19	1004	3.2.1+otr4-1	4	Yes	No	Release for debian jessie/sid and ubuntu trusty only - UNSTABLE!	bzr, ubuntu
2014-07-05	1024	3.2.2	4	Yes	Yes	Official 3.2.2 release	bzr, .deb repo (or APT), .tar.gz

Original extended version of the table

Date	bzr	Release	libotr	Twitter?	Stable?	Notes	Where to get
2013-01-06	965	3.2 ¹	3	No	Yes	The original 3.2 release. Old but stable.	bzr, Release .tar.gz
2013-06-16	991	--	3	Yes	Yes	Earliest dev build with most twitter fixes	bzr
2013-07-13	997	--	3	Yes	Yes	Latest dev build with libotr3 support available from the APT repo	bzr, .deb repo, .tar.gz
2013-10-14	998	--	3	Yes	Yes	Minor bug fix that doesn't have any .deb builds in the repo	bzr, .tar.gz
2013-11-27	999	3.2.1²	3	Yes	Yes	Official 3.2.1 release	bzr, Release .tar.gz
2013-12-05	1000	--	3	Yes	Yes	Minor fix for the displayed version	bzr
2013-12-05	1001	--	4	Yes	No	Switch to libotr4. Several bugs introduced.	bzr
2013-12-19	1004	3.2.1+otr4-1	4	Yes	No	Release for debian jessie/sid and ubuntu trusty only - UNSTABLE!	bzr, ubuntu
2014-01-20	1006	--	4	Yes	No	Fix attempt, unsuccessful.	bzr
2014-01-20	1007	--	4	Yes	Mostly	OTR fixes by pesco! Works flawlessly most of the time.	bzr, .deb repo, .tar.gz
2014-02-13	1011	--	4	Yes	Yes	Two more OTR bugfixes, including a segfault on /me	bzr, .deb repo, .tar.gz
2014-07-05	1024	3.2.2	4	Yes	Yes	Official 3.2.2 release	bzr, .deb repo (or APT), .tar.gz

Also known as 3.2-1 or 3.2-1.1 (1 2)
This release might not display the correct version when you do /ctcp root version (3 4)

The bzr builds before the 3.2.1 release show their version number in the format 3.2+20130714+devel+997-1. In the case of bzr997, it has almost all the features of the 3.2.1 release (except the bugfix from 998), so the "3.2" part of the version number might be misleading, but what matters is the "997" part.

"What should I use?"

libotr version needed	Recommended BitlBee version
libotr 3.x	3.2.1
libotr 4.x	3.2.2
Doesn't matter	3.2.2

OTR

And here's another table for the apparent nonsense of the OTR versions.

Library	Protocol	Allowed protocol policy	.so name (ABI version)	Debian package	Supported bitlbee releases	Supported bitlbee bzr	Stability
libotr 3.2.1	v2	v1, v2	`libotr.so.2.2.1`	libotr2(-dev)	3.0 ... 3.2.1	<=1000	Stable
libotr 4.0.0	v3	v2, v3	`libotr.so.5.0.0`	libotr5(-dev)	3.2.2	>=1001	Stable since r1011

The stability column refers to the current bitlbee support, which might crash in some situations before 1011.

-  ⇤ ← Revision 3 as of 2014-02-07 00:26:32 → 
  Size: 5293
  Editor: dx
  Comment: update for r1007
+   ← Revision 9 as of 2015-01-28 05:01:21 → ⇥
  Size: 6163
  Editor: dx
  Comment: debian is clean now
-Deletions are marked like this.
+Additions are marked like this.
 Line 3:
-== BitlBee ==
+== OTRgate - the transition between 3.2, 3.2.1 and 3.2.2 ==
 Line 6:
+=== Releases only ===

|| '''Date''' || '''bzr''' || '''Release''' || '''libotr''' || '''Twitter?''' || '''Stable?'''  || '''Notes''' || '''Where to get''' ||
|| 2013-01-06 || [[http://code.bitlbee.org/lh/bitlbee/revision/965|965]] || 3.2 <<FootNote(Also known as 3.2-1 or 3.2-1.1)>> || 3 ||<#FFAAAA> No ||<#AAFFAA> Yes || The original 3.2 release. Old but stable. || bzr, [[http://get.bitlbee.org/src/bitlbee-3.2.tar.gz|Release .tar.gz]] ||
|| 2013-11-27 || [[http://code.bitlbee.org/lh/bitlbee/revision/999|999]] || 3.2.1<<FootNote(This release might not display the correct version when you do /ctcp root version)>> || 3 ||<#AAFFAA> Yes ||<#AAFFAA> Yes || Official 3.2.1 release || bzr, [[http://get.bitlbee.org/src/bitlbee-3.2.1.tar.gz|Release .tar.gz]] ||
|| 2013-12-19 || [[http://code.bitlbee.org/lh/bitlbee/revision/1004|1004]] || 3.2.1+otr4-1 || 4 ||<#AAFFAA> Yes ||<#FFAAAA> No || Release for debian jessie/sid and ubuntu trusty only - UNSTABLE! || bzr, '''ubuntu''' ||
|| 2014-07-05 || [[http://code.bitlbee.org/lh/bitlbee/revision/1024|1024]] || 3.2.2 || 4 ||<#AAFFAA> Yes ||<#AAFFAA> Yes || Official 3.2.2 release || bzr, .deb repo (or APT), [[http://code.bitlbee.org/tarballs/bitlbee-bzr-1024.tar.gz|.tar.gz]] ||

=== Original extended version of the table ===
-Line 14:
+Line 24:
-|| 2013-12-05 || [[http://code.bitlbee.org/lh/bitlbee/revision/1001|1001]] || -- || 4 ||<#AAFFAA> Yes ||<#FFAAAA> No || Switch to libotr4. [[http://bugs.bitlbee.org/bitlbee/ticket/1109|Several]] [[http://bugs.bitlbee.org/bitlbee/ticket/1110|bugs]] introduced. || bzr, .deb repo, [[http://code.bitlbee.org/tarballs/bitlbee-bzr-1001.tar.gz|.tar.gz]] ||
|| 2013-12-19 || [[http://code.bitlbee.org/lh/bitlbee/revision/1004|1004]] || 3.2.1+otr4-1 || 4 ||<#AAFFAA> Yes ||<#FFAAAA> No || Release for debian jessie/sid and ubuntu trusty only. || bzr, .deb repo, debian/ubuntu ||
|| 2014-01-20 || [[http://code.bitlbee.org/lh/bitlbee/revision/1006|1006]] || -- || 4 ||<#AAFFAA> Yes ||<#FFAAAA> No || Fix attempt, unsuccessful. || bzr, .deb repo, [[http://code.bitlbee.org/tarballs/bitlbee-bzr-1006.tar.gz|.tar.gz]] ||
|| 2014-01-20 || [[http://code.bitlbee.org/lh/bitlbee/revision/1007|1007]] || -- || 4 ||<#AAFFAA> Yes ||<#AAFFAA> Yes || OTR fixes by pesco! Seems to work flawlessly. || bzr - '''no debian builds yet''' ||
+|| 2013-12-05 || [[http://code.bitlbee.org/lh/bitlbee/revision/1001|1001]] || -- || 4 ||<#AAFFAA> Yes ||<#FFAAAA> No || Switch to libotr4. [[http://bugs.bitlbee.org/bitlbee/ticket/1109|Several]] [[http://bugs.bitlbee.org/bitlbee/ticket/1110|bugs]] introduced. || bzr ||
|| 2013-12-19 || [[http://code.bitlbee.org/lh/bitlbee/revision/1004|1004]] || 3.2.1+otr4-1 || 4 ||<#AAFFAA> Yes ||<#FFAAAA> No || Release for debian jessie/sid and ubuntu trusty only - UNSTABLE! || bzr, '''ubuntu''' ||
|| 2014-01-20 || [[http://code.bitlbee.org/lh/bitlbee/revision/1006|1006]] || -- || 4 ||<#AAFFAA> Yes ||<#FFAAAA> No || Fix attempt, unsuccessful. || bzr ||
|| 2014-01-20 || [[http://code.bitlbee.org/lh/bitlbee/revision/1007|1007]] || -- || 4 ||<#AAFFAA> Yes ||<#FFFFAA> Mostly || OTR fixes by pesco! Works flawlessly most of the time. || bzr, .deb repo, [[http://code.bitlbee.org/tarballs/bitlbee-bzr-1007.tar.gz|.tar.gz]] ||
|| 2014-02-13 || [[http://code.bitlbee.org/lh/bitlbee/revision/1011|1011]] || -- || 4 ||<#AAFFAA> Yes ||<#AAFFAA> Yes || Two more OTR bugfixes, including a segfault on /me || bzr, .deb repo, [[http://code.bitlbee.org/tarballs/bitlbee-bzr-1011.tar.gz|.tar.gz]] ||
|| 2014-07-05 || [[http://code.bitlbee.org/lh/bitlbee/revision/1024|1024]] || 3.2.2 || 4 ||<#AAFFAA> Yes ||<#AAFFAA> Yes || Official 3.2.2 release || bzr, .deb repo (or APT), [[http://code.bitlbee.org/tarballs/bitlbee-bzr-1024.tar.gz|.tar.gz]] ||
-Line 25:
+Line 37:
-|| '''Installation method''' || '''Twitter needed?''' || '''OTR needed?''' || '''Min-max bzr''' || '''Recommended version''' || '''Notes''' ||
|| .deb / APT || Yes || Yes || 991 - 997 or 1007 - *|| 1007 / Latest build. || The latest version in the apt repo is stable now ||
|| .deb / APT || Yes || No || 991 - * || 1007 / Latest build. || The OTR plugin can be kept if using builds >1007 ||
|| .deb / APT || No || No || 965 - *  || 1007 / Latest build. || Same as above. Any version >=3.2 will also work. ||
|| .deb / APT || No || Yes || 965 - 997 or 1007 - * || 1007 / Latest build. || Any version >=3.2 will also work. ||
|| Manual compilation || Yes || -- || 991 - 1000 or 1007 - * || [[http://get.bitlbee.org/src/bitlbee-3.2.1.tar.gz|3.2.1 release]] || You can also try newer bzr revisions since 1007 to compile against libotr4 ||
|| Manual compilation || No || -- || 965 - 1000 or 1007 - * || [[http://get.bitlbee.org/src/bitlbee-3.2.1.tar.gz|3.2.1 release]] || No need to upgrade if you have a version >=3.2. ||
+|| '''libotr version needed''' || '''Recommended !BitlBee version''' ||
|| libotr 3.x || 3.2.1 ||
|| libotr 4.x || 3.2.2 ||
|| Doesn't matter || 3.2.2 ||
-Line 38:
+Line 46:
-|| '''Library''' || '''Protocol''' || '''.so name (ABI version)''' || '''Debian package''' || '''Supported bitlbee releases''' || '''Supported bitlbee bzr''' || '''Stability''' ||
|| libotr 3.2.1 || [[https://otr.cypherpunks.ca/Protocol-v2-3.1.0.html|v2]] || {{{libotr.so.2.2.1}}} || [[http://packages.debian.org/sid/libotr2|libotr2]](-dev)|| 3.0 ... 3.2.1 || <=1000 ||<#AAFFAA> Stable ||
|| libotr 4.0.0 || [[https://otr.cypherpunks.ca/Protocol-v3-4.0.0.html|v3]] || {{{libotr.so.5.0.0}}} || [[http://packages.debian.org/sid/libotr5|libotr5]](-dev)|| Debian's "3.2.1+otr4-1"* || >=1001 ||<#AAFFAA> Stable '''since r1007''' ||
+|| '''Library''' || '''Protocol''' || '''Allowed protocol policy''' || '''.so name (ABI version)''' || '''Debian package''' || '''Supported bitlbee releases''' || '''Supported bitlbee bzr''' || '''Stability''' ||
|| libotr 3.2.1 || [[https://otr.cypherpunks.ca/Protocol-v2-3.1.0.html|v2]] || v1, v2 || {{{libotr.so.2.2.1}}} || [[http://packages.debian.org/sid/libotr2|libotr2]](-dev)|| 3.0 ... 3.2.1 || <=1000 ||<#AAFFAA> Stable ||
|| libotr 4.0.0 || [[https://otr.cypherpunks.ca/Protocol-v3-4.0.0.html|v3]] || v2, v3 || {{{libotr.so.5.0.0}}} || [[http://packages.debian.org/sid/libotr5|libotr5]](-dev)|| 3.2.2 || >=1001 ||<#AAFFAA> Stable '''since r1011''' ||
-Line 42:
+Line 50:
-The stability column refers to the current bitlbee support, which might crash in some situations. [[http://bugs.bitlbee.org/bitlbee/ticket/1110|Bug]]
+The stability column refers to the current bitlbee support, which might crash in some situations before 1011.