Re: [PATCH 2/7] NEWS: Document the notmuch_database_close split

diff --git a/3d/b809a9425af56a65d5395e557ab47c2db4980b b/3d/b809a9425af56a65d5395e557ab47c2db4980b
new file mode 100644 (file)
index 0000000..209c030
--- /dev/null
+++ b/3d/b809a9425af56a65d5395e557ab47c2db4980b
@@ -0,0 +1,104 @@
+Return-Path: <felipe.contreras@gmail.com>\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 EBF47431FAF\r
+       for <notmuch@notmuchmail.org>; Sun, 22 Apr 2012 08:09:22 -0700 (PDT)\r
+X-Virus-Scanned: Debian amavisd-new at olra.theworths.org\r
+X-Spam-Flag: NO\r
+X-Spam-Score: -0.799\r
+X-Spam-Level: \r
+X-Spam-Status: No, score=-0.799 tagged_above=-999 required=5\r
+       tests=[DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1,\r
+       FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_LOW=-0.7] 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 Bl2yzHjXGVEc for <notmuch@notmuchmail.org>;\r
+       Sun, 22 Apr 2012 08:09:22 -0700 (PDT)\r
+Received: from mail-ey0-f181.google.com (mail-ey0-f181.google.com\r
+       [209.85.215.181]) (using TLSv1 with cipher RC4-SHA (128/128 bits))\r
+       (No client certificate requested)\r
+       by olra.theworths.org (Postfix) with ESMTPS id 1E167431FAE\r
+       for <notmuch@notmuchmail.org>; Sun, 22 Apr 2012 08:09:21 -0700 (PDT)\r
+Received: by eaa1 with SMTP id 1so4516282eaa.26\r
+       for <notmuch@notmuchmail.org>; Sun, 22 Apr 2012 08:09:19 -0700 (PDT)\r
+DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113;\r
+       h=mime-version:in-reply-to:references:date:message-id:subject:from:to\r
+       :cc:content-type:content-transfer-encoding;\r
+       bh=LO3BdKTf8ZwRRNWZWpe/Wr3fwAiOxlCzEAnqXmuBDRs=;\r
+       b=wtxuQr1vuqN9KMCwsRs515bMn2w4CTJ6v517y/Y3E3Nu9+GZARe4BDGteXWSff935d\r
+       yWkJe/l5IytSnkSS2JbohsB/XFiw5Td6Y4PwSX+DHF2v6GWgbVO6vfJYzPT04PV9bDv/\r
+       QnEcM4YMg8Usa3bvWEKH6j6i9wmXFnnC8YIe+ChpAwmp/73wETXxTGF+FSMu4jQP7R++\r
+       60ThekCor9B2PWpgyAhHOk/UCjuJH5fzJ0/jEX3MpwjKCyA4XieE5elisZhdJkHzURuQ\r
+       L/jXf377/jvsBb+SfLb5ho5kZCVC163GnSTpKUlZR7CATr4d07Mc4kVpi/qLDJJDU8d+\r
+       P30A==\r
+MIME-Version: 1.0\r
+Received: by 10.14.96.129 with SMTP id r1mr2086776eef.86.1335107359503; Sun,\r
+       22 Apr 2012 08:09:19 -0700 (PDT)\r
+Received: by 10.213.103.18 with HTTP; Sun, 22 Apr 2012 08:09:19 -0700 (PDT)\r
+In-Reply-To:\r
+ <1335096477-27537-2-git-send-email-4winter@informatik.uni-hamburg.de>\r
+References: <20120422120620.26225.40778@thinkbox.jade-hamburg.de>\r
+       <1335096477-27537-1-git-send-email-4winter@informatik.uni-hamburg.de>\r
+       <1335096477-27537-2-git-send-email-4winter@informatik.uni-hamburg.de>\r
+Date: Sun, 22 Apr 2012 18:09:19 +0300\r
+Message-ID:\r
+ <CAMP44s1VhAQT=8_rH0Z2HT3ArDvE7qQWiZA7OAj4gZEXb2ZscQ@mail.gmail.com>\r
+Subject: Re: [PATCH 2/7] NEWS: Document the notmuch_database_close split\r
+From: Felipe Contreras <felipe.contreras@gmail.com>\r
+To: Justus Winter <4winter@informatik.uni-hamburg.de>\r
+Content-Type: text/plain; charset=UTF-8\r
+Content-Transfer-Encoding: quoted-printable\r
+Cc: notmuch@notmuchmail.org\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: Sun, 22 Apr 2012 15:09:23 -0000\r
+\r
+On Sun, Apr 22, 2012 at 3:07 PM, Justus Winter\r
+<4winter@informatik.uni-hamburg.de> wrote:\r
+> Signed-off-by: Justus Winter <4winter@informatik.uni-hamburg.de>\r
+> ---\r
+> =C2=A0NEWS | =C2=A0 12 ++++++++++++\r
+> =C2=A01 file changed, 12 insertions(+)\r
+>\r
+> diff --git a/NEWS b/NEWS\r
+> index c1704e0..a2cd080 100644\r
+> --- a/NEWS\r
+> +++ b/NEWS\r
+> @@ -73,6 +73,18 @@ leaving Mutt. =C2=A0notmuch-mutt, formerly distributed=\r
+ under the name\r
+> =C2=A0"mutt-notmuch" by Stefano Zacchiroli, will be maintained as a notmu=\r
+ch\r
+> =C2=A0contrib/ from now on.\r
+>\r
+> +Library changes\r
+> +---------------\r
+> +\r
+> +API changes\r
+> +\r
+> + =C2=A0The function notmuch_database_close has been split into\r
+> + =C2=A0notmuch_database_close and notmuch_database_destroy.\r
+> +\r
+> + =C2=A0This makes it possible for long running programs to close the xap=\r
+ian\r
+> + =C2=A0database and thus release the lock associated with it without\r
+> + =C2=A0destroying the data structures obtained from it.\r
+> +\r
+\r
+I haven't following this change. Who can an application take advantage\r
+of this? I call _close(), now what do I do to use the database again?\r
+\r
+Cheers.\r
+\r
+--=20\r
+Felipe Contreras\r