[Pkg-privacy-commits] [libotr] 223/225: debian/README.source: document how to detect and handle ABI changes.

[Ximin Luo]

This is an automated email from the git hooks/post-receive script.

infinity0 pushed a commit to branch master
in repository libotr.

commit 538c4adeab978c83c97c1dcdf0680e359b473233
Author: intrigeri <intrigeri at boum.org>
Date:   Mon Nov 3 13:10:01 2014 +0000

    debian/README.source: document how to detect and handle ABI changes.
---
 debian/README.source | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/debian/README.source b/debian/README.source
index f9147b1..21cc55a 100644
--- a/debian/README.source
+++ b/debian/README.source
@@ -1,3 +1,14 @@
 This package follows the Debian OTR Team's workflow and policy,
 as documented on https://wiki.debian.org/Teams/OTR.
 
+This package ships a shared library. So, when upgrading the package:
+
+* dpkg-gensymbols may warn about changed symbols; in this case, update
+  debian/*.symbols; for more information, see
+  https://www.debian.org/doc/manuals/maint-guide/advanced.en.html#librarysymbols
+
+* Manually diff the header files between the previous version and the
+  new one, and look for incompatible ABI changes that dpkg-gensymbols
+  cannot detect, such as changes in an enum or struct. Then, bump the
+  needed version in the symbols file for every function that uses one
+  of the data structure that has changed.

-- 
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/pkg-privacy/packages/libotr.git