[PATCH 02/25] add note about updating the debian symbols file to the RELEASE file

diff --git a/5c/d7abab1963b1ced4e1259922320d38e559d978 b/5c/d7abab1963b1ced4e1259922320d38e559d978
new file mode 100644 (file)
index 0000000..4b5ee26
--- /dev/null
+++ b/5c/d7abab1963b1ced4e1259922320d38e559d978
@@ -0,0 +1,116 @@
+Return-Path: <jrollins@servo.finestructure.net>\r
+X-Original-To: notmuch@notmuchmail.org\r
+Delivered-To: notmuch@notmuchmail.org\r
+Received: from localhost (localhost [127.0.0.1])\r
+       by olra.theworths.org (Postfix) with ESMTP id 234DD429E27\r
+       for <notmuch@notmuchmail.org>; Sat, 28 May 2011 14:52:12 -0700 (PDT)\r
+X-Virus-Scanned: Debian amavisd-new at olra.theworths.org\r
+X-Spam-Flag: NO\r
+X-Spam-Score: -1.921\r
+X-Spam-Level: \r
+X-Spam-Status: No, score=-1.921 tagged_above=-999 required=5\r
+       tests=[NO_DNS_FOR_FROM=0.379, RCVD_IN_DNSWL_MED=-2.3]\r
+       autolearn=disabled\r
+Received: from olra.theworths.org ([127.0.0.1])\r
+       by localhost (olra.theworths.org [127.0.0.1]) (amavisd-new, port 10024)\r
+       with ESMTP id 43EA4eUN9-QP for <notmuch@notmuchmail.org>;\r
+       Sat, 28 May 2011 14:52:11 -0700 (PDT)\r
+Received: from outgoing-mail.its.caltech.edu (outgoing-mail.its.caltech.edu\r
+       [131.215.239.19])\r
+       by olra.theworths.org (Postfix) with ESMTP id 8920B431FD0\r
+       for <notmuch@notmuchmail.org>; Sat, 28 May 2011 14:52:11 -0700 (PDT)\r
+Received: from earth-doxen.imss.caltech.edu (localhost [127.0.0.1])\r
+       by earth-doxen-postvirus (Postfix) with ESMTP id 0C33E66E0343;\r
+       Sat, 28 May 2011 14:52:10 -0700 (PDT)\r
+X-Spam-Scanned: at Caltech-IMSS on earth-doxen by amavisd-new\r
+Received: from servo.finestructure.net (cpe-98-149-172-122.socal.res.rr.com\r
+       [98.149.172.122]) (Authenticated sender: jrollins)\r
+       by earth-doxen-submit (Postfix) with ESMTP id 8119866E019B;\r
+       Sat, 28 May 2011 14:52:04 -0700 (PDT)\r
+Received: by servo.finestructure.net (Postfix, from userid 1000)\r
+       id 1DA5559F; Sat, 28 May 2011 14:52:05 -0700 (PDT)\r
+From: Jameson Graef Rollins <jrollins@finestructure.net>\r
+To: Notmuch Mail <notmuch@notmuchmail.org>\r
+Subject: [PATCH 02/25] add note about updating the debian symbols file to the\r
+       RELEASE file\r
+Date: Sat, 28 May 2011 14:51:37 -0700\r
+Message-Id: <1306619520-25730-3-git-send-email-jrollins@finestructure.net>\r
+X-Mailer: git-send-email 1.7.4.4\r
+In-Reply-To: <1306619520-25730-2-git-send-email-jrollins@finestructure.net>\r
+References: <1306619520-25730-1-git-send-email-jrollins@finestructure.net>\r
+       <1306619520-25730-2-git-send-email-jrollins@finestructure.net>\r
+X-BeenThere: notmuch@notmuchmail.org\r
+X-Mailman-Version: 2.1.13\r
+Precedence: list\r
+List-Id: "Use and development of the notmuch mail system."\r
+       <notmuch.notmuchmail.org>\r
+List-Unsubscribe: <http://notmuchmail.org/mailman/options/notmuch>,\r
+       <mailto:notmuch-request@notmuchmail.org?subject=unsubscribe>\r
+List-Archive: <http://notmuchmail.org/pipermail/notmuch>\r
+List-Post: <mailto:notmuch@notmuchmail.org>\r
+List-Help: <mailto:notmuch-request@notmuchmail.org?subject=help>\r
+List-Subscribe: <http://notmuchmail.org/mailman/listinfo/notmuch>,\r
+       <mailto:notmuch-request@notmuchmail.org?subject=subscribe>\r
+X-List-Received-Date: Sat, 28 May 2011 21:52:12 -0000\r
+\r
+---\r
+ RELEASING |   22 ++++++++++++++++++----\r
+ 1 files changed, 18 insertions(+), 4 deletions(-)\r
+\r
+diff --git a/RELEASING b/RELEASING\r
+index a392d81..475100a 100644\r
+--- a/RELEASING\r
++++ b/RELEASING\r
+@@ -35,7 +35,21 @@ repository. From here, there are just a few steps to release:\r
+ \r
+       Commit this change, if any.\r
+ \r
+-3) Upgrade the version in the file "version"\r
++3) Update the debian/libnotmuch1.symbols file\r
++\r
++      If the library version changed at all (step 2) it probably\r
++      means that symbols have changed/been added, in which case the\r
++      debian symbols file also needs to be updated:\r
++\r
++             dpkg-buildpackage -uc -us\r
++             dpkg-gensymbols -plibnotmuch1 | patch -p0\r
++\r
++      Carefully review the changes to debian/libnotmuch1.symbols to\r
++      make sure there are no unexpected changes.\r
++\r
++      Commit this change, if any.\r
++\r
++4) Upgrade the version in the file "version"\r
+ \r
+       The scheme for the release number is as follows:\r
+ \r
+@@ -55,7 +69,7 @@ repository. From here, there are just a few steps to release:\r
+ \r
+       Commit this change.\r
+ \r
+-4) Create an entry for the new release in debian/changelog\r
++5) Create an entry for the new release in debian/changelog\r
+ \r
+       The syntax of this file is tightly restricted, but the\r
+       available emacs mode (see the dpkg-dev-el package) helps.\r
+@@ -69,7 +83,7 @@ repository. From here, there are just a few steps to release:\r
+       release, (taking entries from NEWS and the version from the\r
+       version file, and creating a new commit, etc.)\r
+ \r
+-5) Run "make release" which will perform the following steps.\r
++6) Run "make release" which will perform the following steps.\r
+ \r
+    Note: If any problem occurs during the process, (such as a lintian\r
+    warning that you decide should be fixed), you can abort at the\r
+@@ -98,7 +112,7 @@ repository. From here, there are just a few steps to release:\r
+       * Push that tag\r
+       * Provide some text for the release announcement (see below).\r
+ \r
+-6) Send a message to notmuch@notmuchmail.org to announce the release.\r
++7) Send a message to notmuch@notmuchmail.org to announce the release.\r
+ \r
+       Use the text provided from "make release" above, (if for some\r
+       reason you lose this message, "make release-message" prints\r
+-- \r
+1.7.4.4\r
+\r