<feed xmlns='http://www.w3.org/2005/Atom'>
<title>notmuch/doc, branch debian/0.27-3</title>
<subtitle>thread-based email index, search, and tagging</subtitle>
<id>https://git.notmuchmail.org/git/notmuch/atom?h=debian%2F0.27-3</id>
<link rel='self' href='https://git.notmuchmail.org/git/notmuch/atom?h=debian%2F0.27-3'/>
<link rel='alternate' type='text/html' href='https://git.notmuchmail.org/git/notmuch/'/>
<updated>2018-05-26T15:31:03Z</updated>
<entry>
<title>docs: add initial documentation for notmuch-tag-jump</title>
<updated>2018-05-26T15:31:03Z</updated>
<author>
<name>David Bremner</name>
<email>david@tethera.net</email>
</author>
<published>2018-05-21T20:08:56Z</published>
<link rel='alternate' type='text/html' href='https://git.notmuchmail.org/git/notmuch/commit/?id=b50fb1b642be5f418db56f00f4518b1d3b2c83eb'/>
<id>urn:sha1:b50fb1b642be5f418db56f00f4518b1d3b2c83eb</id>
<content type='text'>
This is mainly to improve discoverability. It seems that doing
variable cross-references is not easy without using some sphinx
extension/customization.
</content>
</entry>
<entry>
<title>doc: initial documentation for notmuch-tree mode</title>
<updated>2018-05-26T15:29:35Z</updated>
<author>
<name>David Bremner</name>
<email>david@tethera.net</email>
</author>
<published>2018-05-21T20:08:55Z</published>
<link rel='alternate' type='text/html' href='https://git.notmuchmail.org/git/notmuch/commit/?id=7a58c1c44bfc31aea4b4b8698c2941365f3e65b6'/>
<id>urn:sha1:7a58c1c44bfc31aea4b4b8698c2941365f3e65b6</id>
<content type='text'>
</content>
</entry>
<entry>
<title>doc: initial documentation for notmuch-show-mode</title>
<updated>2018-05-26T15:28:18Z</updated>
<author>
<name>David Bremner</name>
<email>david@tethera.net</email>
</author>
<published>2018-05-21T20:08:54Z</published>
<link rel='alternate' type='text/html' href='https://git.notmuchmail.org/git/notmuch/commit/?id=eb6fb36d6337d11788ccd632719917445c7be467'/>
<id>urn:sha1:eb6fb36d6337d11788ccd632719917445c7be467</id>
<content type='text'>
This is pretty minimal, but will hopefully inspire others to
contribute more complete documentation. If nothing else, it points out
'?'.
</content>
</entry>
<entry>
<title>doc: install build and install info pages</title>
<updated>2018-05-26T15:26:13Z</updated>
<author>
<name>David Bremner</name>
<email>david@tethera.net</email>
</author>
<published>2018-05-21T20:08:51Z</published>
<link rel='alternate' type='text/html' href='https://git.notmuchmail.org/git/notmuch/commit/?id=7a6d4a0852664483bbba702cf3b030448b079e2c'/>
<id>urn:sha1:7a6d4a0852664483bbba702cf3b030448b079e2c</id>
<content type='text'>
All of the man pages are installed as info pages, plus
the (unfinished) notmuch-emacs manual
</content>
</entry>
<entry>
<title>cli/show: enable --decrypt=stash</title>
<updated>2018-05-26T14:43:30Z</updated>
<author>
<name>Daniel Kahn Gillmor</name>
<email>dkg@fifthhorseman.net</email>
</author>
<published>2018-05-11T06:57:59Z</published>
<link rel='alternate' type='text/html' href='https://git.notmuchmail.org/git/notmuch/commit/?id=aa605f7e8a4c5e046503d61fdb953721c32f9d3a'/>
<id>urn:sha1:aa605f7e8a4c5e046503d61fdb953721c32f9d3a</id>
<content type='text'>
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 &gt; 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
</content>
</entry>
<entry>
<title>doc: document notmuch new --full-scan</title>
<updated>2018-05-22T16:31:33Z</updated>
<author>
<name>David Bremner</name>
<email>david@tethera.net</email>
</author>
<published>2018-04-29T23:19:43Z</published>
<link rel='alternate' type='text/html' href='https://git.notmuchmail.org/git/notmuch/commit/?id=8a1eeecdfe83a5ca0a923e5d1e31bff076e406ce'/>
<id>urn:sha1:8a1eeecdfe83a5ca0a923e5d1e31bff076e406ce</id>
<content type='text'>
</content>
</entry>
<entry>
<title>doc: fix notmuch-search example</title>
<updated>2018-05-09T14:31:57Z</updated>
<author>
<name>David Bremner</name>
<email>david@tethera.net</email>
</author>
<published>2018-05-08T15:12:55Z</published>
<link rel='alternate' type='text/html' href='https://git.notmuchmail.org/git/notmuch/commit/?id=a07b28a488cd5d8f3d9dcf77401cc43ce6473138'/>
<id>urn:sha1:a07b28a488cd5d8f3d9dcf77401cc43ce6473138</id>
<content type='text'>
For some reason the searched tag did not match the displayed results.
</content>
</entry>
<entry>
<title>doc: document thread subqueries</title>
<updated>2018-05-07T11:42:53Z</updated>
<author>
<name>David Bremner</name>
<email>david@tethera.net</email>
</author>
<published>2018-05-05T15:59:28Z</published>
<link rel='alternate' type='text/html' href='https://git.notmuchmail.org/git/notmuch/commit/?id=f2e6f76a046492650713c1c3f1f1a19f49de59ea'/>
<id>urn:sha1:f2e6f76a046492650713c1c3f1f1a19f49de59ea</id>
<content type='text'>
Mention both performance and quoting issues.
</content>
</entry>
<entry>
<title>doc: add a section on quoting to notmuch-search-terms(7)</title>
<updated>2018-04-25T02:08:10Z</updated>
<author>
<name>David Bremner</name>
<email>david@tethera.net</email>
</author>
<published>2018-04-07T22:10:51Z</published>
<link rel='alternate' type='text/html' href='https://git.notmuchmail.org/git/notmuch/commit/?id=20ba0b7dfae2111f76d71c8d695265014c2ef7c5'/>
<id>urn:sha1:20ba0b7dfae2111f76d71c8d695265014c2ef7c5</id>
<content type='text'>
I think we've diverged enough from the Xapian query parser
that we can't rely on that syntax description [1]. As far as I can
tell, [1] also only discusses quotes in the context of phrases.

[1]: https://xapian.org/docs/queryparser.html
</content>
</entry>
<entry>
<title>doc: Examples of notmuch-reindex use and crypto policy</title>
<updated>2018-03-24T23:08:27Z</updated>
<author>
<name>Daniel Kahn Gillmor</name>
<email>dkg@fifthhorseman.net</email>
</author>
<published>2018-02-21T17:50:27Z</published>
<link rel='alternate' type='text/html' href='https://git.notmuchmail.org/git/notmuch/commit/?id=f6430bc06d479fdf0b180231d3a3b5fb67bbb8e0'/>
<id>urn:sha1:f6430bc06d479fdf0b180231d3a3b5fb67bbb8e0</id>
<content type='text'>
Currently, notmuch has the levers needed to set coherent crypto policy
around how cleartext is indexed, which also has an impact on how
messages are rendered.  But we don't have a lot of documentation about
how to do sensible things.  This is an initial attempt to address
that.

The first example shows a way to selectively index specific messages.

The next two examples are about aligning the existing database with
crypto indexing policy

The default crypto policy is to not index cleartext, and to only
decrypt messages on display when explicitly requested.

The other sensible crypto policy is to index cleartext while stashing
session keys. messages indexed in this way will be searchable, and
will be decrypted on display automatically unless the user explicitly
asks for it to *not* be decrypted.

The policy for indexing *new* messages is stored in the database as
the config variable index.decrypt.

But setting policy for new messages doesn't retroactively affect
already indexed messages.

This patch attempts to document ways that someone can efficiently
align their pre-existing database with their new policy.

I'm not sure this is the right place to document these examples, but i
do want them to be user-facing and relatively easy to find.  I'm happy
to entertain suggestions for where else we should put them.
</content>
</entry>
</feed>
