X-Git-Url: https://git.notmuchmail.org/git?a=blobdiff_plain;f=manpages%2Fnotmuch-show-1.mdwn;fp=manpages%2Fnotmuch-show-1.mdwn;h=39f18455ed3b7317d28420f2b82ada0d36047f65;hb=47c9a681445722a5b996786fb97df71747615bb7;hp=4902b5acffdd090b0c3609e4fec8c0f43980d4dc;hpb=05d265f8a3db616f17022105f8caea43d6225a8f;p=notmuch-wiki diff --git a/manpages/notmuch-show-1.mdwn b/manpages/notmuch-show-1.mdwn index 4902b5a..39f1845 100644 --- a/manpages/notmuch-show-1.mdwn +++ b/manpages/notmuch-show-1.mdwn @@ -110,7 +110,7 @@ supported with --format=json and --format=sexp), and the multiâ part/signed part will be replaced by the signed data. - --decrypt=(false|auto|true) + --decrypt=(false|auto|true|stash) If true, decrypt any MIME encrypted parts found in the selected content (i.e. "multipart/encrypted" parts). Status of the decryption will be reported (currently only supported with @@ -118,50 +118,81 @@ the multipart/encrypted part will be replaced by the decrypted content. - If auto, and a session key is already known for the message, - then it will be decrypted, but notmuch will not try to access + 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 the user's keys. Use false to avoid even automatic decryption. - Non-automatic decryption expects a functioning gpg-agent(1) to - provide 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: true implies --verify. + Note: setting either true or stash here implies --verify. + + Here is a table that summarizes each of these policies: + + ââââââââââââââââ¬ââââââââ¬âââââââ¬âââââââ¬ââââââââ + â â false â auto â true â stash â + ââââââââââââââââ¼ââââââââ¼âââââââ¼âââââââ¼âââââââ⤠+ âShow cleartâ â â X â X â X â + âext if sesâ â â â â â + âsion key is â â â â â + âalready known â â â â â + ââââââââââââââââ¼ââââââââ¼âââââââ¼âââââââ¼âââââââ⤠+ âUse secret â â â X â X â + âkeys to show â â â â â + âcleartext â â â â â + ââââââââââââââââ¼ââââââââ¼âââââââ¼âââââââ¼âââââââ⤠+ âStash any â â â â X â + ânewly recovâ â â â â â + âered session â â â â â + âkeys, reinâ â â â â â + âdexing mesâ â â â â â + âsage if found â â â â â + ââââââââââââââââ´ââââââââ´âââââââ´âââââââ´ââââââââ + + 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.tag_exclude from the search results (the default) or not. In either case the - excluded message will be marked with the exclude flag (except + 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 - returned regardless (with the excluded flag being set when - appropriate) but threads that only match in an excluded message + returned regardless (with the excluded flag being set when + appropriate) 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 json and sexp formats + 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 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=json and --format=sexp). By default, - unless --part=N is used to select a specific part or + Include "text/html" parts as part of the output (currently only + supported with --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. @@ -177,8 +208,8 @@
- 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)@@ -193,4 +224,4 @@ 2009-2018, Carl Worth and many others -