From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp2 ([2001:41d0:8:6d80::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms0.migadu.com with LMTPS id WC0xIa3YrGEpoQAAgWs5BA (envelope-from ) for ; Sun, 05 Dec 2021 16:20:13 +0100 Received: from aspmx1.migadu.com ([2001:41d0:8:6d80::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp2 with LMTPS id mHTvHK3YrGF3WAAAB5/wlQ (envelope-from ) for ; Sun, 05 Dec 2021 15:20:13 +0000 Received: from mail.notmuchmail.org (nmbug.tethera.net [IPv6:2607:5300:201:3100::1657]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by aspmx1.migadu.com (Postfix) with ESMTPS id 32572DB47 for ; Sun, 5 Dec 2021 16:20:13 +0100 (CET) Received: from nmbug.tethera.net (localhost [127.0.0.1]) by mail.notmuchmail.org (Postfix) with ESMTP id 1A89E2880C; Sun, 5 Dec 2021 10:20:08 -0500 (EST) X-Greylist: delayed 344 seconds by postgrey-1.36 at nmbug; Sun, 05 Dec 2021 10:20:04 EST Received: from knopi.disroot.org (knopi.disroot.org [178.21.23.139]) by mail.notmuchmail.org (Postfix) with ESMTPS id C47BC26AA8 for ; Sun, 5 Dec 2021 10:20:04 -0500 (EST) Received: from localhost (localhost [127.0.0.1]) by disroot.org (Postfix) with ESMTP id C70878C1DE for ; Sun, 5 Dec 2021 16:14:18 +0100 (CET) X-Virus-Scanned: Debian amavisd-new at disroot.org Received: from knopi.disroot.org ([127.0.0.1]) by localhost (disroot.org [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id 1VbirGo_zjIY for ; Sun, 5 Dec 2021 16:14:17 +0100 (CET) From: "Jorge P. de Morais Neto" DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=disroot.org; s=mail; t=1638717256; bh=jQyyJZU3UFGzygCnXL1JRaqPULleJ9YGafHNTLFrfZ4=; h=From:To:Subject:Date; b=Ash09JRiznKkAqkXJ0+WN122y4QwRNe5R+Z5JKOr5SJAg9Hi0+BpW4jjR/f/dAo3r kB5fwpO0M03VoQNTmGnT8ODC3bhjInAy5FoaDGAH5oa4R9n9AAdqe5fLUYrpb494cM OlzyNOI6jOzvTehFp8scicdqWoT4rwkpt/J78jmd3Rbf5/CVs08eDLfHGtrd2cJrAw DnVl8cEW8nTWTgJo7SiqtlRvEbCSCynm/+BPA5I4/DkZVX8RPkP3n5txfdlbpO9iNg QoFzazUOcl41/U4cFxsHt3hxa2CCJ5Pw6s+FTUUZuyQLmUWjG65j3s1T+mF4XbcHjN oaDYuRmGahPcQ== To: notmuch@notmuchmail.org Subject: [PATCH] Two tiny clarifications for notmuch-show-mode's docstring Mail-Followup-To: notmuch@notmuchmail.org Date: Sun, 05 Dec 2021 12:14:06 -0300 Message-ID: <87o85vw0ch.fsf@disroot.org> Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="=-=-=" Message-ID-Hash: ZE47VZTX2AI62Q63SHSM7QCE5VTEX2HQ X-Message-ID-Hash: ZE47VZTX2AI62Q63SHSM7QCE5VTEX2HQ X-MailFrom: jorge+list@disroot.org X-Mailman-Rule-Misses: dmarc-mitigation; no-senders; approved; emergency; loop; banned-address; member-moderation; header-match-notmuch.notmuchmail.org-0; nonmember-moderation; administrivia; implicit-dest; max-recipients; max-size; news-moderation; no-subject; digests; suspicious-header X-Mailman-Version: 3.3.3 Precedence: list List-Id: "Use and development of the notmuch mail system." List-Help: List-Owner: List-Post: List-Subscribe: List-Unsubscribe: X-Migadu-Flow: FLOW_IN X-Migadu-Country: FR ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1638717613; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type:list-id: list-help:list-owner:list-unsubscribe:list-subscribe:list-post: dkim-signature; bh=IcKiGrCHI7jTuoOhgEvAS8lDdMYsoxzhBndhHLL5Cjw=; b=JPKLcqD+l1RQCdtrnaR0CbzxzhffD9xMVu+DD3C8pFV5ISQoBq/7RKEdtQ+OIYyRecT5pv QcpjiS/+9Pb9TTiWTDdrU9kFWLgyuTFWtVzxrOSghLaFg4w7fEse51+t7Xx9iTnmGB9FI4 up4gnqS77qvaZ60Cf0OcBBovo5MWWzK9g5hKx/pfJ99oCWvnEvIRyyYziBg5GvzfdDvDPF k3x4+YUQ9Yf+9kP7akLXBZN6QHTe2Gx7wXyOffU3NXhgJXBQyjyAty3bbkb4JiVmLvquLZ LHxVvzNccxpJfAn2ZmWMEIGvWkV6jW4tX+umyogQTqPCH7lfWF6UvpqDjUYB9g== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1638717613; a=rsa-sha256; cv=none; b=mNt+qnm42XcxzLetGEOF+I8EJITXZKMWLR0HG4CQ2G1zzfElLnWu2vk3DBpnVyTcG4uKwg QyFYPsVjb8LMzubeajRQCs9ZKFMAIdvHC5IsqOWsGKrZM1VY9XYRAp5kGO8SyJxfJAxAAv bsTYqXGR43mWl8jC2rD14ecv74KUxZwbJX79XySSBlI7rZZ7/iGObPhntu+18oIaiSat0Z dU0vc4XFMJjYBBAVDcsMK9++mdIO8HL9zLUVNl5KIYEcvS/MNNAanztlruTUzl7Lm7JsLa c98wZrkbw13wOAHqokrCV8GyILnK9BfLb5aL4fEfySTy0RdPs+uzxqO+ObQQJg== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=fail ("body hash did not verify") header.d=disroot.org header.s=mail header.b=Ash09JRi; dmarc=fail reason="SPF not aligned (relaxed)" header.from=disroot.org (policy=quarantine); spf=pass (aspmx1.migadu.com: domain of notmuch-bounces@notmuchmail.org designates 2607:5300:201:3100::1657 as permitted sender) smtp.mailfrom=notmuch-bounces@notmuchmail.org X-Migadu-Spam-Score: 6.00 X-Spam: Yes Authentication-Results: aspmx1.migadu.com; dkim=fail ("body hash did not verify") header.d=disroot.org header.s=mail header.b=Ash09JRi; dmarc=fail reason="SPF not aligned (relaxed)" header.from=disroot.org (policy=quarantine); spf=pass (aspmx1.migadu.com: domain of notmuch-bounces@notmuchmail.org designates 2607:5300:201:3100::1657 as permitted sender) smtp.mailfrom=notmuch-bounces@notmuchmail.org X-Migadu-Queue-Id: 32572DB47 X-Spam-Score: 6.00 X-Migadu-Spam: Yes X-Migadu-Scanner: scn0.migadu.com X-TUID: VypDgHK9bNjL --=-=-= Content-Type: text/x-diff Content-Disposition: inline; filename=0001-emacs-Two-small-clarifications-for-notmuch-show-mode.patch >From edf36bb0d276d2cebe1e3b01dc953b508043a71f Mon Sep 17 00:00:00 2001 From: "Jorge P. de Morais Neto" Date: Thu, 28 Oct 2021 19:33:34 -0300 Subject: [PATCH] emacs: Two small clarifications for notmuch-show-mode's docstring - Prominently inform that `notmuch-show-advance-and-archive' can archive the current thread - Clarify that `notmuch-show-next-message' and `notmuch-show-previous-message' change the "unread" tag. Signed-off-by: Jorge P. de Morais Neto --- emacs/notmuch-show.el | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/emacs/notmuch-show.el b/emacs/notmuch-show.el index 4de3e423..b4afb076 100644 --- a/emacs/notmuch-show.el +++ b/emacs/notmuch-show.el @@ -1532,13 +1532,14 @@ which \\[notmuch-show-next-button] and \\[notmuch-show-previous-button] are help Reading the thread sequentially is well-supported by pressing \\[notmuch-show-advance-and-archive]. This will scroll the current message (if necessary), advance -to the next message, or advance to the next thread (if already on -the last message of a thread). +to the next message, or archive current thread and advance to the next +(if already on the last message of a thread). Other commands are available to read or manipulate the thread more selectively, (such as '\\[notmuch-show-next-message]' and '\\[notmuch-show-previous-message]' to advance to messages -without removing any tags, and '\\[notmuch-show-archive-thread]' to archive an entire thread -without scrolling through with \\[notmuch-show-advance-and-archive]). +without removing any tags other than \"unread\", and +'\\[notmuch-show-archive-thread]' to archive an entire thread without +scrolling through with \\[notmuch-show-advance-and-archive]). You can add or remove arbitrary tags from the current message with '\\[notmuch-show-add-tag]' or '\\[notmuch-show-remove-tag]'. -- 2.33.1 --=-=-= Content-Type: text/plain >From my previous email message from 2020-11-25 (id:878sape5a9.fsf@disroot.org): >> The introduction of help buffer for Notmuch-Show (reached by hitting >> ) describes the command without mentioning that it can >> archive the thread; only in specific description (which does >> not fit in the same window; one has to scroll) does it mention the >> archiving behavior. I believe the archiving behavior should also be >> mentioned in the introduction, lest the user unwittingly archive a >> thread she wasn't supposed to. David Bremner later said on 2021-10-10 (id:87o87ws6np.fsf@tethera.net): > I personally don't think archiving is that destructive, if someone > wants to improve this wording, it is the docstring for > notmuch-show-mode So now I provide the attached patch on its own dedicated thread, according to David Bremner instructions today (id:87o85vql88.fsf@tethera.net). Please give feedback. I have a general grave obsession with details, so I need to calibrate my attention to detail through feedback. Regards! -- - Many people hate injustice but few check the facts; this causes more injustice. Ask me about - I am Brazilian. I hope my English is correct and I welcome feedback. - https://www.defectivebydesign.org - https://www.gnu.org --=-=-= Content-Type: text/plain; charset="us-ascii" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Content-Disposition: inline --=-=-=--