X-Git-Url: https://git.notmuchmail.org/git?p=notmuch;a=blobdiff_plain;f=doc%2Fman1%2Fnotmuch-new.rst;h=3ddd4621a3806c87bc2d54f2391033a6aeb04c92;hp=71df31d77dd64d0e6c5402f34e8b255127a611a2;hb=fccebbaeef1e4b6489425afb13f419543d53d285;hpb=181d4091c408b8ca014ec245ecdae602942b70ce diff --git a/doc/man1/notmuch-new.rst b/doc/man1/notmuch-new.rst index 71df31d7..3ddd4621 100644 --- a/doc/man1/notmuch-new.rst +++ b/doc/man1/notmuch-new.rst @@ -43,19 +43,21 @@ Supported options for **new** include ``--quiet`` Do not print progress or results. - ``--decrypt=(true|auto|false)`` + ``--decrypt=(true|nostash|auto|false)`` If ``true``, when encountering an encrypted message, try to - decrypt it while indexing. If decryption is successful, index - the cleartext itself. If ``auto``, try to use any session key - already known to belong to this message, but do not attempt to - use the user's secret keys. - - Be aware that the index is likely - sufficient to reconstruct the cleartext of the message itself, - so please ensure that the notmuch message index is adequately - protected. DO NOT USE ``--decrypt=true`` without - considering the security of your index. + decrypt it while indexing, and stash any discovered session + keys. If ``auto``, try to use any session key already known + to belong to this message, but do not attempt to use the + user's secret keys. If decryption is successful, index the + cleartext of the message. + + Be aware that the index is likely sufficient (and the session + key is certainly sufficient) to reconstruct the cleartext of + the message itself, so please ensure that the notmuch message + index is adequately protected. DO NOT USE ``--decrypt=true`` + or ``--decrypt=nostash`` without considering the security of + your index. See also ``index.decrypt`` in **notmuch-config(1)**.