From: Daniel Kahn Gillmor Date: Fri, 8 Dec 2017 06:23:56 +0000 (-0500) Subject: cli/show, reply: document use of stashed session keys in notmuch-properties X-Git-Tag: 0.26_rc0~42 X-Git-Url: https://git.notmuchmail.org/git?p=notmuch;a=commitdiff_plain;h=f845fb2a51f87dfa60388d65ac481ba21556bb78;ds=sidebyside cli/show, reply: document use of stashed session keys in notmuch-properties The stashed session keys are stored internally as notmuch properties. So a user or developer who is reading about those properties might want to understand how they fit into the bigger picture. Note here that decrypting with a stored session key no longer needs -decrypt for "notmuch show" and "notmuch reply". --- diff --git a/doc/man7/notmuch-properties.rst b/doc/man7/notmuch-properties.rst index 05444f6c..1a3f690e 100644 --- a/doc/man7/notmuch-properties.rst +++ b/doc/man7/notmuch-properties.rst @@ -77,9 +77,12 @@ of its normal activity. **session-key** When **notmuch-show(1)** or **nomtuch-reply** encounters a message - with an encrypted part and ``--decrypt`` is set, if notmuch finds a - ``session-key`` property associated with the message, it will try - that stashed session key for decryption. + with an encrypted part, if notmuch finds a ``session-key`` + property associated with the message, it will try that stashed + session key for decryption. + + If you do not want to use any stashed session keys that might be + present, you should pass those programs ``--decrypt=false``. Using a stashed session key with "notmuch show" will speed up rendering of long encrypted threads. It also allows the user to