Differences between revisions 7 and 8

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, debian/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, debian/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 7 as of 2014-07-14 12:49:34 → 
  Size: 5556
  Editor: dx
  Comment: make it more obvious that +otr4-1 is unstable
+   ← Revision 8 as of 2014-07-29 15:38:55 → ⇥
  Size: 6177
  Editor: dx
  Comment: moinmoin doesn't show diffs, i don't know.
-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, '''debian/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 17:
+Line 27:
-|| 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, .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 || A few more minor OTR bugfixes. || 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 || 3.2.2 stable release || bzr, .deb repo (or APT), [[http://code.bitlbee.org/tarballs/bitlbee-bzr-1024.tar.gz|.tar.gz]] ||
+|| 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 27:
+Line 37:
-|| '''Installation method''' || '''Twitter needed?''' || '''OTR needed?''' || '''Min-max bzr''' || '''Recommended version''' || '''Notes''' ||
|| .deb / APT || Yes || Yes || 991 - 997 or 1007 - *|| 3.2.2 / Latest build. || The latest version in the apt repo is stable now ||
|| .deb / APT || Yes || No || 991 - * || 3.2.2 / Latest build. || The OTR plugin can be kept if using builds >1007 ||
|| .deb / APT || No || No || 965 - *  || 3.2.2 / Latest build. || Same as above. Any version >=3.2 will also work. ||
|| .deb / APT || No || Yes || 965 - 997 or 1007 - * || 3.2.2 / Latest build. || Any version >=3.2 will also work. ||
|| Manual compilation || Yes || -- || 991 - 1000 or 1007 - * || [[http://get.bitlbee.org/src/bitlbee-3.2.2.tar.gz|3.2.2 release]] ||  ||
|| Manual compilation || No || -- || 965 - 1000 or 1007 - * || [[http://get.bitlbee.org/src/bitlbee-3.2.2.tar.gz|3.2.2 release]] ||  ||
+|| '''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 42:
+Line 48:
-|| 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 r1007''' ||
+|| 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 44:
+Line 50:
-The stability column refers to the current bitlbee support, which might crash in some situations before 1007.
+The stability column refers to the current bitlbee support, which might crash in some situations before 1011.