notmuch/doc/man1
Daniel Kahn Gillmor aa605f7e8a cli/show: enable --decrypt=stash
Add fancy new feature, which makes "notmuch show" capable of actually
indexing messages that it just decrypted.

This enables a workflow where messages can come in in the background
and be indexed using "--decrypt=auto".  But when showing an encrypted
message for the first time, it gets automatically indexed.

This is something of a departure for "notmuch show" -- in particular,
because it requires read/write access to the database.  However, this
might be a common use case -- people get mail delivered and indexed in
the background, but only want access to their secret key to happen
when they're directly interacting with notmuch itself.

In such a scenario, they couldn't search newly-delivered, encrypted
messages, but they could search for them once they've read them.

Documentation of this new feature also uses a table form, similar to
that found in the description of index.decrypt in notmuch-config(1).

A notmuch UI that wants to facilitate this workflow while also
offering an interactive search interface might instead make use of
these additional commands while the user is at the console:

Count received encrypted messages (if > 0, there are some things we
haven't yet tried to index, and therefore can't yet search):

     notmuch count tag:encrypted and \
         not property:index.decryption=success and \
         not property:index.decryption=failure

Reindex those messages:

     notmuch reindex --try-decrypt=true tag:encrypted and \
         not property:index.decryption=success and \
         not property:index.decryption=failure
2018-05-26 07:43:30 -07:00
..
notmuch-address.rst doc: unify definition list usage across man pages 2017-12-31 09:06:11 -04:00
notmuch-compact.rst doc: unify definition list usage across man pages 2017-12-31 09:06:11 -04:00
notmuch-config.rst fix typos 2018-01-04 20:35:58 -04:00
notmuch-count.rst doc: unify definition list usage across man pages 2017-12-31 09:06:11 -04:00
notmuch-dump.rst doc: unify definition list usage across man pages 2017-12-31 09:06:11 -04:00
notmuch-emacs-mua.rst doc: unify definition list usage across man pages 2017-12-31 09:06:11 -04:00
notmuch-insert.rst cli/insert: add --world-readable flag 2018-03-24 20:08:11 -03:00
notmuch-new.rst doc: document notmuch new --full-scan 2018-05-22 09:31:33 -07:00
notmuch-reindex.rst doc: Examples of notmuch-reindex use and crypto policy 2018-03-24 20:08:27 -03:00
notmuch-reply.rst doc/{reply, show}: match indentation 2017-12-31 09:34:28 -04:00
notmuch-restore.rst doc: unify definition list usage across man pages 2017-12-31 09:06:11 -04:00
notmuch-search.rst doc: fix notmuch-search example 2018-05-09 10:31:57 -04:00
notmuch-show.rst cli/show: enable --decrypt=stash 2018-05-26 07:43:30 -07:00
notmuch-tag.rst doc: unify definition list usage across man pages 2017-12-31 09:06:11 -04:00
notmuch.rst doc: unify definition list usage across man pages 2017-12-31 09:06:11 -04:00