notmuch/doc/man1
Daniel Kahn Gillmor be555b9d27 docs: clean up documentation about decryption policies
Now that the range of sensible decryption policies has come into full
view, we take a bit of space to document the distinctions.

Most people will use either "auto" or "true" -- but we provide "false"
and "nostash" to handle use cases that might reasonably be requested.

Note also that these can be combined in sensible ways.  Like, if your
mail comes in regularly to a service that doesn't have access to your
secret keys, but does have access to your index, and you feel
comfortable adding selected encrypted messages to the index after
you've read them, you could stay in "auto" normally, and then when you
find yourself reading an indexable message (e.g. one you want to be
able to search for in the future, and that you don't mind exposing to
whatever entities have access to your inde), you can do:

    notmuch reindex --decrypt=true id:whatever@example.biz

That leaves your default the same (still "auto") but you get the
cleartext index and stashed session key benefits for that particular
message.
2017-12-08 08:08:47 -04:00
..
notmuch-address.rst doc: make SEE ALSO references one-per-line 2017-10-18 22:36:39 -03:00
notmuch-compact.rst doc: make SEE ALSO references one-per-line 2017-10-18 22:36:39 -03:00
notmuch-config.rst docs: clean up documentation about decryption policies 2017-12-08 08:08:47 -04:00
notmuch-count.rst doc: make SEE ALSO references one-per-line 2017-10-18 22:36:39 -03:00
notmuch-dump.rst doc: add notmuch-properties(7) 2017-10-21 19:52:55 -03:00
notmuch-emacs-mua.rst notmuch-emacs-mua: add --hello parameter 2016-11-26 08:15:11 -04:00
notmuch-insert.rst crypto: add --decrypt=nostash to avoid stashing session keys 2017-12-08 08:08:47 -04:00
notmuch-new.rst crypto: add --decrypt=nostash to avoid stashing session keys 2017-12-08 08:08:47 -04:00
notmuch-reindex.rst crypto: add --decrypt=nostash to avoid stashing session keys 2017-12-08 08:08:47 -04:00
notmuch-reply.rst cli/reply: use decryption policy "auto" by default. 2017-12-08 08:08:46 -04:00
notmuch-restore.rst doc: add notmuch-properties(7) 2017-10-21 19:52:55 -03:00
notmuch-search.rst doc: make SEE ALSO references one-per-line 2017-10-18 22:36:39 -03:00
notmuch-show.rst cli/show: use decryption policy "auto" by default. 2017-12-08 08:08:46 -04:00
notmuch-tag.rst doc: make SEE ALSO references one-per-line 2017-10-18 22:36:39 -03:00
notmuch.rst doc: add notmuch-properties(7) 2017-10-21 19:52:55 -03:00