[PATCH 6/7] doc: clarifications for the new --sort flag and emacs command

Subject: [PATCH 6/7] doc: clarifications for the new --sort flag and emacs command

Date: Sat, 26 Jun 2021 03:28:45 +0100

To: notmuch@notmuchmail.org

Cc: jao

From: jao

Improvements to the notmuch show manpage regarding the behaviour of
--sort, and description in doc/notmuch-emacs.rst of the new
notmuch-tree-toggle-order command for notmuch-tree buffers.
 doc/man1/notmuch-show.rst | 4 ++++
 doc/notmuch-emacs.rst     | 7 +++++++
 2 files changed, 11 insertions(+)

diff --git a/doc/man1/notmuch-show.rst b/doc/man1/notmuch-show.rst
index 581d15b5..64639174 100644
--- a/doc/man1/notmuch-show.rst
+++ b/doc/man1/notmuch-show.rst
@@ -117,6 +117,10 @@ Supported options for **show** include
    order (**oldest-first**) or reverse chronological order
+   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).
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.
     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
notmuch mailing list -- notmuch@notmuchmail.org
To unsubscribe send an email to notmuch-leave@notmuchmail.org