Differences between revisions 1 and 10 (spanning 9 versions)

Version reference tables

OTRgate - the transition between 3.2, 3.2.1 and 3.2.2

Obsolete

This was a big deal around 2014-2015 but it's over now. It's kept for historical reasons.

Just ignore this and use the version and be happy.

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 1 as of 2014-01-25 21:28:05 → 
  Size: 4937
  Editor: dx
  Comment: YAY TABLES
+   ← Revision 10 as of 2016-05-07 23:30:18 → ⇥
  Size: 6352
  Editor: dx
  Comment: mark this thing as obsolete
-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 ==

{{{#!wiki warning
'''Obsolete'''

This was a big deal around 2014-2015 but it's over now. It's kept for historical reasons.

Just ignore this and use the version and be happy.
}}}
-Line 6:
+Line 14:
+=== 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 32:
-|| 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 for [[http://bugs.bitlbee.org/bitlbee/ticket/1109|this OTR bug]]. || bzr, .deb repo (or APT), [[http://code.bitlbee.org/tarballs/bitlbee-bzr-1006.tar.gz|.tar.gz]] ||
+|| 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 24:
+Line 45:
-|| '''Installation method''' || '''Twitter needed?''' || '''OTR needed?''' || '''Min. bzr''' || '''Max. bzr''' || '''Recommended version''' || '''Notes''' ||
|| .deb / APT || Yes || Yes || 991 || 997 || 997 || Downgrade manually if using the apt repo ||
|| .deb / APT || Yes || No || 991 || -- || Latest build. || '''Remove bitlbee-plugin-otr.''' ||
|| .deb / APT || No || No || 965 || --  || Latest build. || '''Remove bitlbee-plugin-otr.'''. Any version >=3.2 will also work. ||
|| .deb / APT || No || Yes || 965 || 997 || 997 || Downgrade manually if using the apt repo. Any version >=3.2 will also work. ||
|| Manual compilation || Yes || -- || 991 || 1000 || [[http://get.bitlbee.org/src/bitlbee-3.2.1.tar.gz|3.2.1 release]] || Don't bother using newer bzr revisions. ||
|| Manual compilation || No || -- || 965 || 1000 || [[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. Again, don't use newer bzr revisions. ||
+|| '''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 37:
+Line 54:
-|| '''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 ||<#FFAAAA> Unstable ||
+|| '''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''' ||

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