unofficial mirror of notmuch@notmuchmail.org
 help / color / mirror / code / Atom feed
From: jao <jao@gnu.org>
To: notmuch@notmuchmail.org
Cc: jao <jao@gnu.org>
Subject: [PATCH 4/7] doc: updates for new --sort and related emacs commands
Date: Sat, 26 Jun 2021 03:28:43 +0100	[thread overview]
Message-ID: <20210626022846.233052-5-jao@gnu.org> (raw)
In-Reply-To: <20210626022846.233052-1-jao@gnu.org>

New --sort CLI option documented in notmuch-show's man page, and
notmuch-search-toggle-order mentioned in devel/emacs-keybindings.org.
---
 devel/emacs-keybindings.org | 10 +++++-----
 doc/man1/notmuch-show.rst   |  9 +++++++++
 2 files changed, 14 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..581d15b5 100644
--- a/doc/man1/notmuch-show.rst
+++ b/doc/man1/notmuch-show.rst
@@ -111,6 +111,15 @@ 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**).
+
+   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
-- 
2.32.0

  parent reply	other threads:[~2021-06-26  2:29 UTC|newest]

Thread overview: 24+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2021-06-26  2:28 New --sort for notmuch show and using it in emacs notmuch-tree-mode jao
2021-06-26  2:28 ` [PATCH 1/7] CLI/show: accept --sort jao
2021-06-26  2:28 ` [PATCH 2/7] emacs/hello: honouring :sort-order in threaded queries jao
2021-06-26  2:28 ` [PATCH 3/7] emacs/tree: command to toggle search sort order in tree mode jao
2021-06-26 10:31   ` David Bremner
2021-06-26 15:38     ` Jose Antonio Ortega Ruiz
2021-06-26  2:28 ` jao [this message]
2021-06-26 10:36   ` [PATCH 4/7] doc: updates for new --sort and related emacs commands David Bremner
2021-06-26  2:28 ` [PATCH 5/7] CLI/show: tests for the new --sort option jao
2021-06-26  2:28 ` [PATCH 6/7] doc: clarifications for the new --sort flag and emacs command jao
2021-06-26  2:28 ` [PATCH 7/7] emacs: fix notmuch-tree-toggle-order keybinding jao
2021-06-26 10:41   ` David Bremner
2021-06-26 10:46     ` David Bremner
2021-06-26 15:41       ` Jose Antonio Ortega Ruiz
2021-06-26 16:55         ` Jose Antonio Ortega Ruiz
2021-06-26 17:42           ` David Bremner
2021-06-26 18:08             ` Jose Antonio Ortega Ruiz
2021-06-26 18:02 ` [PATCH 1/5] CLI/show: accept --sort jao
2021-06-26 18:06 ` Here's a re-roll, with review comments so far addressed jao
2021-06-26 18:06   ` [PATCH 1/5] CLI/show: accept --sort jao
2021-06-26 18:06   ` [PATCH 2/5] CLI/show: tests for the new --sort option jao
2021-06-26 18:06   ` [PATCH 3/5] emacs/hello: honouring :sort-order in threaded queries jao
2021-06-26 18:06   ` [PATCH 4/5] emacs/tree: command to toggle search sort order in tree mode jao
2021-06-26 18:06   ` [PATCH 5/5] doc: new notmuch show --sort and related emacs commands jao

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

  List information: https://notmuchmail.org/

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20210626022846.233052-5-jao@gnu.org \
    --to=jao@gnu.org \
    --cc=notmuch@notmuchmail.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
Code repositories for project(s) associated with this public inbox

	https://yhetil.org/notmuch.git/

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).