From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: 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