doc: document new option show.extra_headers

Increase discoverability by cross referencing from the notmuch-show
manual entry to the notmuch-config manual entry.
This commit is contained in:
David Bremner 2022-01-18 09:26:59 -04:00
parent 88633bc7a7
commit 3bf6487359
2 changed files with 21 additions and 0 deletions

View file

@ -145,6 +145,20 @@ search.exclude\_tags
Default: empty list. Note that :any:`notmuch-setup(1)` puts Default: empty list. Note that :any:`notmuch-setup(1)` puts
``deleted;spam`` here when creating new configuration file. ``deleted;spam`` here when creating new configuration file.
.. _show.extra_headers:
show.extra\_headers
By default :any:`notmuch-show(1)` includes the following headers
in structured output if they are present in the message:
`Subject`, `From`, `To`, `Cc`, `Bcc`, `Reply-To`, `Date`. This
option allows the specification of a list of further
headers to output.
History: This configuration value was introduced in notmuch 0.35.
Default: empty list.
maildir.synchronize\_flags maildir.synchronize\_flags
If true, then the following maildir flags (in message filenames) If true, then the following maildir flags (in message filenames)
will be synchronized with the corresponding notmuch tags: will be synchronized with the corresponding notmuch tags:

View file

@ -221,6 +221,13 @@ email messages. For this, use a search term of "thread:<thread-id>" as
can be seen in the first column of output from the can be seen in the first column of output from the
:any:`notmuch-search(1)` command. :any:`notmuch-search(1)` command.
CONFIGURATION
=============
Structured output (json / sexp) is influenced by the configuration
option :ref:`show.extra_headers <show.extra_headers>`. See
:any:`notmuch-config(1)` for details.
EXIT STATUS EXIT STATUS
=========== ===========