[PATCH v3 07/15] cli/show, reply: document use of stashed session keys in notmuch-properties
Daniel Kahn Gillmor
dkg at fifthhorseman.net
Thu Dec 7 22:23:56 PST 2017
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".
---
doc/man7/notmuch-properties.rst | 9 ++++++---
1 file changed, 6 insertions(+), 3 deletions(-)
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
--
2.15.0
More information about the notmuch
mailing list