notmuch/doc/man1/notmuch.rst, branch 0.32

CLI/config: default to storing all config in external files

2021-03-27T12:26:14Z

Previously the fact that some configuration options were only stored in the database (and thus editing the config file had no effect) was a source of user confusion. This was fixed with the series ending at d9af0af1646. On the other hand, the underlying partition of config options into those stored by default in the database and those stored in the config file remained. This is also confusing, since now some invocations of "notmuch config set" modify the config file, and others silently modify the database instead. With this commit, it is up to the user to decide which configuration to modify. A new "--database" option is provided for notmuch config to enable modifying the configuration information in the database; otherwise the default is to update an external config file.

notmuch(1): clarify documentation about --option/value separators

2020-05-08T11:58:46Z

id:CA+Tk8fzRiqxWpd=r8=DRvEewNZXUZgD7MKyRLB1A=R-LxxGEZw@mail.gmail.com started a thread of discussion that showed that the cli's current idiosyncrasies around dealing with boolean options were not understandable. This attempts to improve the documentation at least (actual changes to the API might be better, but have not reached consensus). Note that no one in the discussion thread identified any other (non-boolean) command-line options that cannot use space as a separator. If such an option is identified (or introduced in the future), it should be added explicitly to this part of the manual. Signed-off-by: Daniel Kahn Gillmor

doc: unify definition list usage across man pages

2017-12-31T13:06:11Z

Make all parameter descriptions etc. use reStructuredText definition lists with uniform style and indentation. Remove redundant indentation from around the lists. Remove blank lines between term lines and definition blocks. Use four spaces for indentation. This is almost completely whitespace and paragraph reflow changes.

doc: add notmuch-properties(7)

2017-10-21T22:52:55Z

We will want a user-facing place to record details about the use of notmuch properties shortly. This establishes a new manual page for that purpose.

doc: make SEE ALSO references one-per-line

2017-10-19T01:36:39Z

This will make future diffs cleaner, make it easier to keep them alphabetical, and make it easier to scan and search the documentation sources.

add "notmuch reindex" subcommand

2017-08-02T01:17:47Z

This new subcommand takes a set of search terms, and re-indexes the list of matching messages.

Fix orthography

2017-07-18T09:50:44Z

cli: add space separator for keyword, string, and int arguments

2017-07-12T20:46:29Z

Defer the complication of optional boolean arguments for later (never?).

man: document external subcommand handling in notmuch(1)

2017-03-07T13:05:50Z

The documentation for this was overlooked when adding the subcommand handling. This seems like the proper place for it.

doc: update cross references for notmuch.1

2016-08-23T23:53:52Z

In particular add notmuch-compact(1) (Debian bug #825884)