notmuch/doc
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
..
man1 cli/show: enable --decrypt=stash 2018-05-26 07:43:30 -07:00
man5 doc: unify definition list usage across man pages 2017-12-31 09:06:11 -04:00
man7 doc: document thread subqueries 2018-05-07 08:42:53 -03:00
.gitignore Use rooted paths in .gitignore files 2017-08-18 19:42:35 -03:00
conf.py doc: add 2018 to copyright year 2018-01-01 21:17:05 -04:00
doxygen.cfg Use https instead of http where possible 2016-06-05 08:32:17 -03:00
index.rst doc: add notmuch-properties(7) 2017-10-21 19:52:55 -03:00
INSTALL doc: remove support for rst2man 2015-01-22 08:37:25 +01:00
Makefile doc: convert sphinx based docs 2014-03-09 10:41:08 -03:00
Makefile.local doc: create manpage folders with right permissions 2018-01-31 21:22:04 -04:00
notmuch-emacs.rst doc: fix references in notmuch-emacs.rst 2016-11-17 08:39:04 -04:00