Re: [PATCH] emacs: Mention race condition safety in user visible documentation

diff --git a/17/78725dadab3f136fd9741ebe44e7404a60cad3 b/17/78725dadab3f136fd9741ebe44e7404a60cad3
new file mode 100644 (file)
index 0000000..65c4e1e
--- /dev/null
+++ b/17/78725dadab3f136fd9741ebe44e7404a60cad3
@@ -0,0 +1,107 @@
+Return-Path: <pieter@praet.org>\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 D6F89431FB6\r
+       for <notmuch@notmuchmail.org>; Wed, 22 Feb 2012 12:07:09 -0800 (PST)\r
+X-Virus-Scanned: Debian amavisd-new at olra.theworths.org\r
+X-Spam-Flag: NO\r
+X-Spam-Score: -0.7\r
+X-Spam-Level: \r
+X-Spam-Status: No, score=-0.7 tagged_above=-999 required=5\r
+       tests=[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 s3JGH7IVU1+S for <notmuch@notmuchmail.org>;\r
+       Wed, 22 Feb 2012 12:07:09 -0800 (PST)\r
+Received: from mail-wi0-f181.google.com (mail-wi0-f181.google.com\r
+       [209.85.212.181]) (using TLSv1 with cipher RC4-SHA (128/128 bits))\r
+       (No client certificate requested)\r
+       by olra.theworths.org (Postfix) with ESMTPS id 0C1E4431FAE\r
+       for <notmuch@notmuchmail.org>; Wed, 22 Feb 2012 12:07:08 -0800 (PST)\r
+Received: by wibhi8 with SMTP id hi8so326552wib.26\r
+       for <notmuch@notmuchmail.org>; Wed, 22 Feb 2012 12:07:07 -0800 (PST)\r
+Received-SPF: pass (google.com: domain of pieter@praet.org designates\r
+       10.216.139.165 as permitted sender) client-ip=10.216.139.165; \r
+Authentication-Results: mr.google.com;\r
+       spf=pass (google.com: domain of pieter@praet.org\r
+       designates 10.216.139.165 as permitted sender)\r
+       smtp.mail=pieter@praet.org\r
+Received: from mr.google.com ([10.216.139.165])\r
+       by 10.216.139.165 with SMTP id c37mr9806786wej.53.1329941227883\r
+       (num_hops = 1); Wed, 22 Feb 2012 12:07:07 -0800 (PST)\r
+X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;\r
+       d=google.com; s=gamma;\r
+       h=from:to:cc:subject:in-reply-to:references:user-agent:date\r
+       :message-id:mime-version:content-type:x-gm-message-state;\r
+       bh=J5ZZeFJ4B+N099wFVS/7oPmt4svyJOR/5vpsRXWWnik=;\r
+       b=tAzE0U10tCULcTNZoutSHuTZbVm7sYV3dLdmb3BU2FvkV1+31gYlYztb3A0afDDUDU\r
+       Q5+Jm38z6NjAs/VaFaPsfuJbyrwYu1HMjwmmFA87gtkweNw83LkisviwxIIgrhZO5fsg\r
+       hJIWBB/5o6ht2M4D5b5LabzSi0dInu438mmLY=\r
+Received: by 10.216.139.165 with SMTP id c37mr8115486wej.53.1329941227736;\r
+       Wed, 22 Feb 2012 12:07:07 -0800 (PST)\r
+Received: from localhost ([109.131.181.26])\r
+       by mx.google.com with ESMTPS id bg3sm4057599wib.10.2012.02.22.12.07.06\r
+       (version=TLSv1/SSLv3 cipher=OTHER);\r
+       Wed, 22 Feb 2012 12:07:07 -0800 (PST)\r
+From: Pieter Praet <pieter@praet.org>\r
+To: Michal Sojka <sojkam1@fel.cvut.cz>,\r
+       Mark Walters <markwalters1009@gmail.com>, Jani Nikula <jani@nikula.org>\r
+Subject: Re: [PATCH] emacs: Mention race condition safety in user visible\r
+       documentation\r
+In-Reply-To: <87linwsg2r.fsf@steelpick.2x.cz>\r
+References: <1329605059-15358-1-git-send-email-sojkam1@fel.cvut.cz>\r
+       <CAB+hUn907hwS46jM4FY+BAhBTE1VMaMs=q0PFEou3DfWWaDF8g@mail.gmail.com>\r
+       <87y5rzmg5v.fsf@steelpick.2x.cz> <87vcn0tw1f.fsf@qmul.ac.uk>\r
+       <87linwsg2r.fsf@steelpick.2x.cz>\r
+User-Agent: Notmuch/0.11.1+210~g6afc43e (http://notmuchmail.org) Emacs/23.3.1\r
+       (x86_64-unknown-linux-gnu)\r
+Date: Wed, 22 Feb 2012 21:04:50 +0100\r
+Message-ID: <8762ey8wil.fsf@praet.org>\r
+MIME-Version: 1.0\r
+Content-Type: text/plain; charset=us-ascii\r
+X-Gm-Message-State:\r
+ ALoCoQl+4cCjDowH803R8gDRUM0/F2ZuN9nZ+bszPcg9ctBFkzWfdY+Lmpak89D9J8ktZi5FRA5t\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: Wed, 22 Feb 2012 20:07:10 -0000\r
+\r
+On Tue, 21 Feb 2012 10:15:08 +0100, Michal Sojka <sojkam1@fel.cvut.cz> wrote:\r
+> [...]\r
+> OK, at least one supporter here :) The updated patch follows:\r
+> \r
+> -- >8 --\r
+> Subject: [PATCH] emacs: Clarify description of thread manipulating functions\r
+> \r
+> It is not clear whether the term "thread" refers to the thread in the\r
+> database or to the thread currently shown in a buffer. Those two\r
+> meanings may refer to different sets of messages, e.g. when a new email\r
+> is added to the database while the buffer shows the state before the new\r
+> email arrived.\r
+> \r
+> This patch replaces the term thread with the term current buffer, which\r
+> is hopefully less ambiguous.\r
+> ---\r
+\r
++1\r
+\r
+\r
+Also, the inverse is true for the comment about `notmuch-search-tag-all'\r
+in `notmuch-search-mode's docstring.  Patch follows.\r
+\r
+\r
+Peace\r
+\r
+-- \r
+Pieter\r