X-Git-Url: https://git.cworth.org/git?p=notmuch-wiki;a=blobdiff_plain;f=manpages%2Fnotmuch-show-1.mdwn;h=fb28d27b2717ae9905914a22c480e3882586de2d;hp=4a3831a6d2325e667613d9d1cdcfa859683925aa;hb=85fe2a1e7df8ccbb172ebf5f10e3cf574a08944a;hpb=82a6b98a10839f24d79526eb2fed8ddb1f87eb14 diff --git a/manpages/notmuch-show-1.mdwn b/manpages/notmuch-show-1.mdwn index 4a3831a..fb28d27 100644 --- a/manpages/notmuch-show-1.mdwn +++ b/manpages/notmuch-show-1.mdwn @@ -103,35 +103,47 @@ part still has two MIME parts: part 0 is the whole message (headers and body) and part 1 is just the body. + --sort=(newest-first|oldest-first) + This option can be used to present results in either chronologi‐ + cal order (oldest-first) or reverse chronological order (new- + est-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). + --verify Compute and report the validity of any MIME cryptographic signa‐ - tures found in the selected content (e.g., "multipart/signed" + tures found in the selected content (e.g., "multipart/signed" parts). Status of the signature will be reported (currently only - supported with --format=json and --format=sexp), and the multi‐ + supported with --format=json and --format=sexp), and the multi‐ part/signed part will be replaced by the signed data. --decrypt=(false|auto|true|stash) - If true, decrypt any MIME encrypted parts found in the selected - content (e.g., "multipart/encrypted" parts). Status of the de‐ - cryption will be reported (currently only supported with --for- - mat=json and --format=sexp) and on successful decryption the - multipart/encrypted part will be replaced by the decrypted con‐ + If true, decrypt any MIME encrypted parts found in the selected + content (e.g., "multipart/encrypted" parts). Status of the de‐ + cryption will be reported (currently only supported with --for- + mat=json and --format=sexp) and on successful decryption the + multipart/encrypted part will be replaced by the decrypted con‐ tent. - stash behaves like true, but upon successful decryption it will - also stash the message's session key in the database, and index - the cleartext of the message, enabling automatic decryption in + stash behaves like true, but upon successful decryption it will + also stash the message's session key in the database, and index + the cleartext of the message, enabling automatic decryption in the future. - If auto, and a session key is already known for the message, - then it will be decrypted, but notmuch will not try to access + If auto, and a session key is already known for the message, + then it will be decrypted, but notmuch will not try to access the user's keys. Use false to avoid even automatic decryption. - Non-automatic decryption (stash or true, in the absence of a - stashed session key) expects a functioning gpg-agent(1) to pro‐ - vide any needed credentials. Without one, the decryption will + Non-automatic decryption (stash or true, in the absence of a + stashed session key) expects a functioning gpg-agent(1) to pro‐ + vide any needed credentials. Without one, the decryption will fail. Note: setting either true or stash here implies --verify. @@ -147,7 +159,7 @@ │already known │ │ │ │ │ ├──────────────┼───────┼──────┼──────┼───────┤ │Use secret │ │ │ X │ X │ - │keys to show │ │ │ │ │ + │keys to show │ │ │ │ │ │cleartext │ │ │ │ │ ├──────────────┼───────┼──────┼──────┼───────┤ │Stash any │ │ │ │ X │ @@ -158,44 +170,44 @@ │sage if found │ │ │ │ │ └──────────────┴───────┴──────┴──────┴───────┘ - Note: --decrypt=stash requires write access to the database. + Note: --decrypt=stash requires write access to the database. Otherwise, notmuch show operates entirely in read-only mode. Default: auto --exclude=(true|false) - Specify whether to omit threads only matching search.ex‐ - clude_tags from the search results (the default) or not. In ei‐ - ther case the excluded message will be marked with the exclude - flag (except when output=mbox when there is nowhere to put the + Specify whether to omit threads only matching search.ex‐ + clude_tags from the search results (the default) or not. In ei‐ + ther case the excluded message will be marked with the exclude + flag (except when output=mbox when there is nowhere to put the flag). - If --entire-thread is specified then complete threads are re‐ - turned regardless (with the excluded flag being set when appro‐ - priate) but threads that only match in an excluded message are + If --entire-thread is specified then complete threads are re‐ + turned regardless (with the excluded flag being set when appro‐ + priate) but threads that only match in an excluded message are not returned when --exclude=true. The default is --exclude=true. --body=(true|false) - If true (the default) notmuch show includes the bodies of the - messages in the output; if false, bodies are omitted. - --body=false is only implemented for the text, json and sexp + If true (the default) notmuch show includes the bodies of the + messages in the output; if false, bodies are omitted. + --body=false is only implemented for the text, json and sexp formats and it is incompatible with --part > 0. This is useful if the caller only needs the headers as body-less output is much faster and substantially smaller. --include-html - Include "text/html" parts as part of the output (currently only - supported with --format=text, --format=json and --format=sexp). + Include "text/html" parts as part of the output (currently only + supported with --format=text, --format=json and --format=sexp). By default, unless --part=N is used to select a specific part or --include-html is used to include all "text/html" parts, no part with content type "text/html" is included in the output. - A common use of notmuch show is to display a single thread of email + A common use of notmuch show is to display a single thread of email messages. For this, use a search term of "thread:<thread-id>" as can be - seen in the first column of output from the notmuch search command. + seen in the first column of output from the notmuch-search(1) command.

EXIT STATUS

@@ -209,8 +221,8 @@

SEE ALSO

-       notmuch(1), notmuch-config(1), notmuch-count(1), notmuch-dump(1),  not‐
-       much-hooks(5),   notmuch-insert(1),  notmuch-new(1),  notmuch-reply(1),
+       notmuch(1),  notmuch-config(1), notmuch-count(1), notmuch-dump(1), not‐
+       much-hooks(5),  notmuch-insert(1),  notmuch-new(1),   notmuch-reply(1),
        notmuch-restore(1),  notmuch-search(1),  notmuch-search-terms(7),  not‐
        much-tag(1)
@@ -225,4 +237,4 @@ 2009-2021, Carl Worth and many others -

0.32

+

0.33