From de6fcc588ae76f82613f30dca78bd4492424c812 Mon Sep 17 00:00:00 2001 From: Michal Sojka Date: Sat, 18 Feb 2012 23:44:18 +0100 Subject: [PATCH] [PATCH] emacs: Mention race condition safety in user visible documentation --- 84/06e3dd36bd11a59aafd6d838c9a101f8a05218 | 101 ++++++++++++++++++++++ 1 file changed, 101 insertions(+) create mode 100644 84/06e3dd36bd11a59aafd6d838c9a101f8a05218 diff --git a/84/06e3dd36bd11a59aafd6d838c9a101f8a05218 b/84/06e3dd36bd11a59aafd6d838c9a101f8a05218 new file mode 100644 index 000000000..3d7f2f71b --- /dev/null +++ b/84/06e3dd36bd11a59aafd6d838c9a101f8a05218 @@ -0,0 +1,101 @@ +Return-Path: +X-Original-To: notmuch@notmuchmail.org +Delivered-To: notmuch@notmuchmail.org +Received: from localhost (localhost [127.0.0.1]) + by olra.theworths.org (Postfix) with ESMTP id 36FAF431FB6 + for ; Sat, 18 Feb 2012 14:44:37 -0800 (PST) +X-Virus-Scanned: Debian amavisd-new at olra.theworths.org +X-Spam-Flag: NO +X-Spam-Score: -2.3 +X-Spam-Level: +X-Spam-Status: No, score=-2.3 tagged_above=-999 required=5 + tests=[RCVD_IN_DNSWL_MED=-2.3] autolearn=disabled +Received: from olra.theworths.org ([127.0.0.1]) + by localhost (olra.theworths.org [127.0.0.1]) (amavisd-new, port 10024) + with ESMTP id HlbF1jBjBIlN for ; + Sat, 18 Feb 2012 14:44:36 -0800 (PST) +Received: from max.feld.cvut.cz (max.feld.cvut.cz [147.32.192.36]) + by olra.theworths.org (Postfix) with ESMTP id B2B6C431FAE + for ; Sat, 18 Feb 2012 14:44:36 -0800 (PST) +Received: from localhost (unknown [192.168.200.4]) + by max.feld.cvut.cz (Postfix) with ESMTP id 4FF0A19F35E0; + Sat, 18 Feb 2012 23:44:35 +0100 (CET) +X-Virus-Scanned: IMAP AMAVIS +Received: from max.feld.cvut.cz ([192.168.200.1]) + by localhost (styx.feld.cvut.cz [192.168.200.4]) (amavisd-new, + port 10044) + with ESMTP id 7Q0djq5YFbhH; Sat, 18 Feb 2012 23:44:34 +0100 (CET) +Received: from imap.feld.cvut.cz (imap.feld.cvut.cz [147.32.192.34]) + by max.feld.cvut.cz (Postfix) with ESMTP id 0D02F19F35D5; + Sat, 18 Feb 2012 23:44:34 +0100 (CET) +Received: from steelpick.2x.cz (unknown [213.29.198.144]) + (Authenticated sender: sojkam1) + by imap.feld.cvut.cz (Postfix) with ESMTPSA id EC834660968; + Sat, 18 Feb 2012 23:44:33 +0100 (CET) +Received: from wsh by steelpick.2x.cz with local (Exim 4.77) + (envelope-from ) + id 1Ryt17-00040G-F6; Sat, 18 Feb 2012 23:44:33 +0100 +From: Michal Sojka +To: notmuch@notmuchmail.org +Subject: [PATCH] emacs: Mention race condition safety in user visible + documentation +Date: Sat, 18 Feb 2012 23:44:18 +0100 +Message-Id: <1329605059-15358-1-git-send-email-sojkam1@fel.cvut.cz> +X-Mailer: git-send-email 1.7.7.3 +X-BeenThere: notmuch@notmuchmail.org +X-Mailman-Version: 2.1.13 +Precedence: list +List-Id: "Use and development of the notmuch mail system." + +List-Unsubscribe: , + +List-Archive: +List-Post: +List-Help: +List-Subscribe: , + +X-List-Received-Date: Sat, 18 Feb 2012 22:44:37 -0000 + +After recent rework of a/A/x/X key bindings, the important paragraph in +documentation of `notmuch-show-archive-thread' stayed hidden from users, +because no key is bound to this function. + +This patch copies the important paragraph to the documentation of +functions currently bound to keys. +--- + emacs/notmuch-show.el | 14 ++++++++++++-- + 1 files changed, 12 insertions(+), 2 deletions(-) + +diff --git a/emacs/notmuch-show.el b/emacs/notmuch-show.el +index aa9ccee..1916146 100644 +--- a/emacs/notmuch-show.el ++++ b/emacs/notmuch-show.el +@@ -1721,13 +1721,23 @@ buffer." + (notmuch-show-tag-all (concat op "inbox")))) + + (defun notmuch-show-archive-thread-then-next () +- "Archive each message in thread, then show next thread from search." ++ "Archive each message in thread, then show next thread from search. ++ ++Note: This command is safe from any race condition of new messages ++being delivered to the same thread. It does not archive the ++entire thread, but only the messages shown in the current ++buffer." + (interactive) + (notmuch-show-archive-thread) + (notmuch-show-next-thread t)) + + (defun notmuch-show-archive-thread-then-exit () +- "Archive each message in thread, then exit back to search results." ++ "Archive each message in thread, then exit back to search results. ++ ++Note: This command is safe from any race condition of new messages ++being delivered to the same thread. It does not archive the ++entire thread, but only the messages shown in the current ++buffer." + (interactive) + (notmuch-show-archive-thread) + (notmuch-show-next-thread)) +-- +1.7.7.3 + -- 2.26.2