doc: new notmuch show --sort and related emacs commands

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).
This commit is contained in:
jao 2021-07-02 21:44:24 +01:00 committed by David Bremner
parent e333debbd8
commit 32f42581e3
3 changed files with 25 additions and 5 deletions

View file

@ -15,7 +15,7 @@
| l | notmuch-search-filter | notmuch-show-filter-thread | | | l | notmuch-search-filter | notmuch-show-filter-thread | |
| m | notmuch-mua-new-mail | notmuch-mua-new-mail | notmuch-mua-new-mail | | 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 | | 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 | | 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 | | 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 | | 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 | | V | | notmuch-show-view-raw-message | notmuch-show-view-raw-message |
| X | | notmuch-show-archive-thread-then-exit | | | X | | notmuch-show-archive-thread-then-exit | |
| Z | notmuch-tree-from-search-current-query | notmuch-tree-from-show-current-query | | | Z | notmuch-tree-from-search-current-query | notmuch-tree-from-show-current-query | |
| =!= | | notmuch-show-toggle-elide-non-matching | | | =!= | | notmuch-show-toggle-elide-non-matching | |
| =#= | | notmuch-show-print-message | | | =#= | | notmuch-show-print-message | |
| =$= | | notmuch-show-toggle-process-crypto | | | =$= | | notmuch-show-toggle-process-crypto | |
| =*= | notmuch-search-tag-all | notmuch-show-tag-all | notmuch-tree-tag-thread | | =*= | 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-add-tag | notmuch-show-add-tag | notmuch-tree-add-tag |
| - | notmuch-search-remove-tag | notmuch-show-remove-tag | notmuch-tree-remove-tag | | - | notmuch-search-remove-tag | notmuch-show-remove-tag | notmuch-tree-remove-tag |
| . | | notmuch-show-part-map | | | . | | notmuch-show-part-map | |

View file

@ -111,6 +111,19 @@ Supported options for **show** include
part still has two MIME parts: part 0 is the whole message part still has two MIME parts: part 0 is the whole message
(headers and body) and part 1 is just the body. (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 .. option:: --verify
Compute and report the validity of any MIME cryptographic Compute and report the validity of any MIME cryptographic

View file

@ -299,12 +299,19 @@ tags.
``p`` ``p``
Move to previous matching message Move to previous matching message
``o`` ``notmuch-tree-toggle-order``
|docstring::notmuch-tree-toggle-order|
``g`` ``=`` ``g`` ``=``
Refresh the buffer Refresh the buffer
``?`` ``?``
Display full set of key bindings 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 Global key bindings
=================== ===================