NEWS: News for big endian sha1 bug fix.
authorDavid Bremner <david@tethera.net>
Sun, 24 Nov 2013 21:29:43 +0000 (17:29 -0400)
committerDavid Bremner <david@tethera.net>
Mon, 25 Nov 2013 12:02:50 +0000 (08:02 -0400)
We could give more details about how to migrate tags, but I'm not sure
that it's a practical problem, or just a theoretical one.

NEWS

diff --git a/NEWS b/NEWS
index 3383ecfb9e19bf349c0e454e36394365259c6062..184bd0e00a7b4d21fdabfc39f241f528b64496e1 100644 (file)
--- a/NEWS
+++ b/NEWS
@@ -1,6 +1,22 @@
-Notmuch 0.17~rc1 (2013-11-20)
+Notmuch 0.17~rc2 (2013-xx-yy)
 =============================
 
+Incompatible change in SHA1 computation
+---------------------------------------
+
+Previously on big endian architectures like sparc and powerpc the
+computation of SHA1 hashes was incorrect. This meant that messages
+with overlong or missing message-ids were given different computed
+message-ids than on more common little endian architectures like i386
+and amd64.  If you use notmuch on a big endian architecture, you are
+strongly advised to make a backup of your tags using `notmuch dump`
+before this upgrade. You can locate the affected files using something
+like:
+
+    notmuch dump | \
+      awk '/^notmuch-sha1-[0-9a-f]{40} / \
+        {system("notmuch search --exclude=false --output=files id:" $1)}'
+
 Command-Line Interface
 ----------------------