From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp0 ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms0.migadu.com with LMTPS id aMhyDM5632AHVwAAgWs5BA (envelope-from ) for ; Fri, 02 Jul 2021 22:45:02 +0200 Received: from aspmx1.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp0 with LMTPS id 8xkwCM5632BSAgAA1q6Kng (envelope-from ) for ; Fri, 02 Jul 2021 20:45:02 +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 9A1F6AA88 for ; Fri, 2 Jul 2021 22:45:01 +0200 (CEST) Received: from nmbug.tethera.net (localhost [127.0.0.1]) by mail.notmuchmail.org (Postfix) with ESMTP id 389D5290D0; Fri, 2 Jul 2021 16:44:44 -0400 (EDT) Received: from eggs.gnu.org (eggs.gnu.org [IPv6:2001:470:142:3::10]) by mail.notmuchmail.org (Postfix) with ESMTPS id 48C5126C01 for ; Fri, 2 Jul 2021 16:44:32 -0400 (EDT) Received: from fencepost.gnu.org ([2001:470:142:3::e]:44320) by eggs.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1lzQ1X-00088C-VX; Fri, 02 Jul 2021 16:44:31 -0400 Received: from cpc103048-sgyl39-2-0-cust502.18-2.cable.virginm.net ([92.233.85.247]:47788 helo=osgiliath.local) by fencepost.gnu.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1lzQ1X-0001Wt-N9; Fri, 02 Jul 2021 16:44:31 -0400 From: jao To: notmuch@notmuchmail.org Subject: [PATCH v3 5/5] doc: new notmuch show --sort and related emacs commands Date: Fri, 2 Jul 2021 21:44:24 +0100 Message-Id: <20210702204424.2018666-6-jao@gnu.org> X-Mailer: git-send-email 2.32.0 In-Reply-To: <20210702204424.2018666-1-jao@gnu.org> References: <20210702204424.2018666-1-jao@gnu.org> MIME-Version: 1.0 Message-ID-Hash: QG2E735RYCGFKC6OAHE4R25ZFYVX5RMI X-Message-ID-Hash: QG2E735RYCGFKC6OAHE4R25ZFYVX5RMI X-MailFrom: jao@gnu.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; suspicious-header CC: jao X-Mailman-Version: 3.2.1 Precedence: list List-Id: "Use and development of the notmuch mail system." List-Help: List-Post: List-Subscribe: List-Unsubscribe: Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Migadu-Flow: FLOW_IN ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1625258701; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references:list-id:list-help: list-unsubscribe:list-subscribe:list-post; bh=hWx2qiW/klkUNPjZZLvPomSudVBTzEfV5SiQozh57MM=; b=Neu7mtYJTgpzDGIxluLx7I8g8MoCnGbMf32yLS6TV1c5a3f7fukmd36rYAqRNEHhXBagtu lApbUedrn921gjz1pbkHlaVvzK0F6Ffh/O5DF3a8BIDte+IUyd8YbZObol06n5TIbeNPRs qEN9alxx7boDRH76qe5hMzxXy/v48VDRfCJO91PRsVmyCYa2ziprMBTOhjSsCtMpe38rLG q492CaaCRFkQVvPxiACR1zfF3U9Bf1f71QMsh3fGUmgiJnjk/H47YWJGdVQWCTZz4kyKft rJuklpTaaAwcebwlT9qX5IM4Me2NLiFOwLgaX4xChLIh3jYioykxrEJ6IlXbpQ== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1625258701; a=rsa-sha256; cv=none; b=hlJ1orx7lqpRFTWgP/KWKfP8ZwSdZl1CUR5O3v8NOgfGe12VdooEySQyliT70njKSqTwzp xSqPE87j5ILon5z4X7w6TRvCFp0lfVMQI9PWW4kBDWaLcsr5v0Q9gWbiOmYdb8S3RWY1kS DUU6pLZQ91kX7dL8uGj/4PwAP9k1gITs9tV98o1SXp5G/y01a5z71/V+tuFAD2EzliWOAN iVI5p/K844PtQ7K/JBIKBj/2u/NvnZAaJAR8/NP0nWZPV2ac7b/TZLJgU8zFuQIjubniJ5 AUjjg76C04oULaGNL35Hb9HfWZj6LzAIGjcG20Lzwf4EShDRcYPVrXt4JfoXEQ== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=none; dmarc=fail reason="SPF not aligned (relaxed), No valid DKIM" header.from=gnu.org (policy=none); 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: -0.92 Authentication-Results: aspmx1.migadu.com; dkim=none; dmarc=fail reason="SPF not aligned (relaxed), No valid DKIM" header.from=gnu.org (policy=none); 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: 9A1F6AA88 X-Spam-Score: -0.92 X-Migadu-Scanner: scn0.migadu.com X-TUID: 0bhXRzybd67i New --sort CLI option documented in notmuch-show's man page, and notmuch-search-toggle-order mentioned in doc/notmuch-emacs.rst and devel/emacs-keybindings.org (in the latter, there's also some whitespace changes in a table introduced by org-mode). --- devel/emacs-keybindings.org | 10 +++++----- doc/man1/notmuch-show.rst | 13 +++++++++++++ doc/notmuch-emacs.rst | 7 +++++++ 3 files changed, 25 insertions(+), 5 deletions(-) diff --git a/devel/emacs-keybindings.org b/devel/emacs-keybindings.org index 65dfe0eb..f7df3040 100644 --- a/devel/emacs-keybindings.org +++ b/devel/emacs-keybindings.org @@ -15,7 +15,7 @@ | l | notmuch-search-filter | notmuch-show-filter-thread | | | m | notmuch-mua-new-mail | notmuch-mua-new-mail | notmuch-mua-new-mail | | n | notmuch-search-next-thread | notmuch-show-next-open-message | notmuch-tree-next-matching-message | -| o | notmuch-search-toggle-order | | | +| o | notmuch-search-toggle-order | | notmuch-tree-toggle-order | | p | notmuch-search-previous-thread | notmuch-show-previous-open-message | notmuch-tree-prev-matching-message | | q | notmuch-bury-or-kill-this-buffer | notmuch-bury-or-kill-this-buffer | notmuch-bury-or-kill-this-buffer | | r | notmuch-search-reply-to-thread-sender | notmuch-show-reply-sender | notmuch-show-reply-sender | @@ -38,10 +38,10 @@ | V | | notmuch-show-view-raw-message | notmuch-show-view-raw-message | | X | | notmuch-show-archive-thread-then-exit | | | Z | notmuch-tree-from-search-current-query | notmuch-tree-from-show-current-query | | -| =!= | | notmuch-show-toggle-elide-non-matching | | -| =#= | | notmuch-show-print-message | | -| =$= | | notmuch-show-toggle-process-crypto | | -| =*= | notmuch-search-tag-all | notmuch-show-tag-all | notmuch-tree-tag-thread | +| =!= | | notmuch-show-toggle-elide-non-matching | | +| =#= | | notmuch-show-print-message | | +| =$= | | notmuch-show-toggle-process-crypto | | +| =*= | notmuch-search-tag-all | notmuch-show-tag-all | notmuch-tree-tag-thread | | + | notmuch-search-add-tag | notmuch-show-add-tag | notmuch-tree-add-tag | | - | notmuch-search-remove-tag | notmuch-show-remove-tag | notmuch-tree-remove-tag | | . | | notmuch-show-part-map | | diff --git a/doc/man1/notmuch-show.rst b/doc/man1/notmuch-show.rst index fc6bec62..64639174 100644 --- a/doc/man1/notmuch-show.rst +++ b/doc/man1/notmuch-show.rst @@ -111,6 +111,19 @@ Supported options for **show** include part still has two MIME parts: part 0 is the whole message (headers and body) and part 1 is just the body. +.. option:: --sort=(newest-first|oldest-first) + + This option can be used to present results in either chronological + order (**oldest-first**) or reverse chronological order + (**newest-first**). + + Only threads as a whole are reordered. Ordering of messages within + each thread will not be affected by this flag, since that order is + always determined by the thread's replies. + + By default, results will be displayed in reverse chronological + order, (that is, the newest results will be displayed first). + .. option:: --verify Compute and report the validity of any MIME cryptographic diff --git a/doc/notmuch-emacs.rst b/doc/notmuch-emacs.rst index 7772871b..952fe2a5 100644 --- a/doc/notmuch-emacs.rst +++ b/doc/notmuch-emacs.rst @@ -299,12 +299,19 @@ tags. ``p`` Move to previous matching message +``o`` ``notmuch-tree-toggle-order`` + |docstring::notmuch-tree-toggle-order| + ``g`` ``=`` Refresh the buffer ``?`` Display full set of key bindings +As is the case with :ref:`notmuch-search`, the presentation of results +can be controlled by the variable ``notmuch-search-oldest-first``. + + Global key bindings =================== -- 2.32.0