doc: remove explicit formatting of terms in definition lists

Sphinx-doc already formats the terms appropriately for a given
backend (bold in html and man). `makeinfo` complains noisily about
formatting inside a @item if we add our own explicit formatting.

This change may change the formatting in the info output. On the other
hand, the existing use of quotes for bold is not that great anyway.

In some places blank lines were removed to preserve the logical
structure of a definition list.
This commit is contained in:
David Bremner 2021-10-11 09:56:14 -03:00
parent 2ce6c76a61
commit 00fdf10937
10 changed files with 64 additions and 66 deletions

View file

@ -42,7 +42,7 @@ Supported options for **address** include
neither ``--output=sender`` nor ``--output=recipients`` is neither ``--output=sender`` nor ``--output=recipients`` is
given, ``--output=sender`` is implied. given, ``--output=sender`` is implied.
**sender** sender
Output all addresses from the *From* header. Output all addresses from the *From* header.
Note: Searching for **sender** should be much faster than Note: Searching for **sender** should be much faster than
@ -50,17 +50,17 @@ Supported options for **address** include
cached directly in the database whereas other addresses need cached directly in the database whereas other addresses need
to be fetched from message files. to be fetched from message files.
**recipients** recipients
Output all addresses from the *To*, *Cc* and *Bcc* headers. Output all addresses from the *To*, *Cc* and *Bcc* headers.
**count** count
Print the count of how many times was the address encountered Print the count of how many times was the address encountered
during search. during search.
Note: With this option, addresses are printed only after the Note: With this option, addresses are printed only after the
whole search is finished. This may take long time. whole search is finished. This may take long time.
**address** address
Output only the email addresses instead of the full mailboxes Output only the email addresses instead of the full mailboxes
with names and email addresses. This option has no effect on with names and email addresses. This option has no effect on
the JSON or S-Expression output formats. the JSON or S-Expression output formats.
@ -69,17 +69,17 @@ Supported options for **address** include
Control the deduplication of results. Control the deduplication of results.
**no** no
Output all occurrences of addresses in the matching Output all occurrences of addresses in the matching
messages. This is not applicable with ``--output=count``. messages. This is not applicable with ``--output=count``.
**mailbox** mailbox
Deduplicate addresses based on the full, case sensitive name Deduplicate addresses based on the full, case sensitive name
and email address, or mailbox. This is effectively the same as and email address, or mailbox. This is effectively the same as
piping the ``--deduplicate=no`` output to **sort | uniq**, except piping the ``--deduplicate=no`` output to **sort | uniq**, except
for the order of results. This is the default. for the order of results. This is the default.
**address** address
Deduplicate addresses based on the case insensitive address Deduplicate addresses based on the case insensitive address
part of the mailbox. Of all the variants (with different name part of the mailbox. Of all the variants (with different name
or case), print the one occurring most frequently among the or case), print the one occurring most frequently among the

View file

@ -55,14 +55,14 @@ The available configuration items are described below. Non-absolute
paths are presumed relative to `$HOME` for items in section paths are presumed relative to `$HOME` for items in section
**database**. **database**.
**database.path** database.path
Notmuch will store its database here, (in Notmuch will store its database here, (in
sub-directory named ``.notmuch`` if **database.mail\_root** sub-directory named ``.notmuch`` if **database.mail\_root**
is unset). is unset).
Default: see :ref:`database` Default: see :ref:`database`
**database.mail_root** database.mail_root
The top-level directory where your mail currently exists and to The top-level directory where your mail currently exists and to
where mail will be delivered in the future. Files should be where mail will be delivered in the future. Files should be
individual email messages. individual email messages.
@ -72,7 +72,7 @@ paths are presumed relative to `$HOME` for items in section
Default: For compatibility with older configurations, the value of Default: For compatibility with older configurations, the value of
database.path is used if **database.mail\_root** is unset. database.path is used if **database.mail\_root** is unset.
**database.backup_dir** database.backup_dir
Directory to store tag dumps when upgrading database. Directory to store tag dumps when upgrading database.
History: this configuration value was introduced in notmuch 0.32. History: this configuration value was introduced in notmuch 0.32.
@ -80,7 +80,7 @@ paths are presumed relative to `$HOME` for items in section
Default: A sibling directory of the Xapian database called Default: A sibling directory of the Xapian database called
`backups`. `backups`.
**database.hook_dir** database.hook_dir
Directory containing hooks run by notmuch commands. See Directory containing hooks run by notmuch commands. See
:any:`notmuch-hooks(5)`. :any:`notmuch-hooks(5)`.
@ -88,7 +88,7 @@ paths are presumed relative to `$HOME` for items in section
Default: See HOOKS, below. Default: See HOOKS, below.
**database.autocommit** database.autocommit
How often to commit transactions to disk. `0` means wait until How often to commit transactions to disk. `0` means wait until
command completes, otherwise an integer `n` specifies to commit to command completes, otherwise an integer `n` specifies to commit to
@ -96,30 +96,30 @@ paths are presumed relative to `$HOME` for items in section
History: this configuration value was introduced in notmuch 0.33. History: this configuration value was introduced in notmuch 0.33.
**user.name** user.name
Your full name. Your full name.
Default: ``$NAME`` variable if set, otherwise read from Default: ``$NAME`` variable if set, otherwise read from
``/etc/passwd``. ``/etc/passwd``.
**user.primary\_email** user.primary\_email
Your primary email address. Your primary email address.
Default: ``$EMAIL`` variable if set, otherwise constructed from Default: ``$EMAIL`` variable if set, otherwise constructed from
the username and hostname of the current machine. the username and hostname of the current machine.
**user.other\_email** user.other\_email
A list of other email addresses at which you receive email. A list of other email addresses at which you receive email.
Default: not set. Default: not set.
**new.tags** new.tags
A list of tags that will be added to all messages incorporated by A list of tags that will be added to all messages incorporated by
**notmuch new**. **notmuch new**.
Default: ``unread;inbox``. Default: ``unread;inbox``.
**new.ignore** new.ignore
A list to specify files and directories that will not be searched A list to specify files and directories that will not be searched
for messages by :any:`notmuch-new(1)`. Each entry in the list is either: for messages by :any:`notmuch-new(1)`. Each entry in the list is either:
@ -137,7 +137,7 @@ paths are presumed relative to `$HOME` for items in section
Default: empty list. Default: empty list.
**search.exclude\_tags** search.exclude\_tags
A list of tags that will be excluded from search results by A list of tags that will be excluded from search results by
default. Using an excluded tag in a query will override that default. Using an excluded tag in a query will override that
exclusion. exclusion.
@ -145,7 +145,7 @@ paths are presumed relative to `$HOME` for items in section
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.
**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:
@ -178,7 +178,7 @@ paths are presumed relative to `$HOME` for items in section
Default: ``true``. Default: ``true``.
**index.decrypt** index.decrypt
Policy for decrypting encrypted messages during indexing. Must be Policy for decrypting encrypted messages during indexing. Must be
one of: ``false``, ``auto``, ``nostash``, or ``true``. one of: ``false``, ``auto``, ``nostash``, or ``true``.
@ -231,7 +231,7 @@ paths are presumed relative to `$HOME` for items in section
Default: ``auto``. Default: ``auto``.
**index.header.<prefix>** index.header.<prefix>
Define the query prefix <prefix>, based on a mail header. For Define the query prefix <prefix>, based on a mail header. For
example ``index.header.List=List-Id`` will add a probabilistic example ``index.header.List=List-Id`` will add a probabilistic
prefix ``List:`` that searches the ``List-Id`` field. User prefix ``List:`` that searches the ``List-Id`` field. User
@ -240,18 +240,18 @@ paths are presumed relative to `$HOME` for items in section
supported. See :any:`notmuch-search-terms(7)` for a list of existing supported. See :any:`notmuch-search-terms(7)` for a list of existing
prefixes, and an explanation of probabilistic prefixes. prefixes, and an explanation of probabilistic prefixes.
**built_with.<name>** built_with.<name>
Compile time feature <name>. Current possibilities include Compile time feature <name>. Current possibilities include
"retry_lock" (configure option, included by default). "retry_lock" (configure option, included by default).
(since notmuch 0.30, "compact" and "field_processor" are (since notmuch 0.30, "compact" and "field_processor" are
always included.) always included.)
**query.<name>** query.<name>
Expansion for named query called <name>. See Expansion for named query called <name>. See
:any:`notmuch-search-terms(7)` for more information about named :any:`notmuch-search-terms(7)` for more information about named
queries. queries.
**squery.<name>** squery.<name>
Expansion for named query called <name>, using s-expression syntax. See Expansion for named query called <name>, using s-expression syntax. See
:any:`notmuch-sexp-queries(7)` for more information about s-expression :any:`notmuch-sexp-queries(7)` for more information about s-expression
queries. queries.

View file

@ -28,13 +28,13 @@ Supported options for **count** include
.. option:: --output=(messages|threads|files) .. option:: --output=(messages|threads|files)
**messages** messages
Output the number of matching messages. This is the default. Output the number of matching messages. This is the default.
**threads** threads
Output the number of matching threads. Output the number of matching threads.
**files** files
Output the number of files associated with matching Output the number of files associated with matching
messages. This may be bigger than the number of matching messages. This may be bigger than the number of matching
messages due to duplicates (i.e. multiple files having the messages due to duplicates (i.e. multiple files having the

View file

@ -39,7 +39,7 @@ Supported options for **dump** include
Notmuch restore supports two plain text dump formats, both with Notmuch restore supports two plain text dump formats, both with
one message-id per line, followed by a list of tags. one message-id per line, followed by a list of tags.
**batch-tag** batch-tag
The default **batch-tag** dump format is intended to more The default **batch-tag** dump format is intended to more
robust against malformed message-ids and tags containing robust against malformed message-ids and tags containing
whitespace or non-\ :manpage:`ascii(7)` characters. Each line whitespace or non-\ :manpage:`ascii(7)` characters. Each line
@ -58,7 +58,7 @@ Supported options for **dump** include
:any:`notmuch-tag(1)`; note that the single message-id query is :any:`notmuch-tag(1)`; note that the single message-id query is
mandatory for :any:`notmuch-restore(1)`. mandatory for :any:`notmuch-restore(1)`.
**sup** sup
The **sup** dump file format is specifically chosen to be The **sup** dump file format is specifically chosen to be
compatible with the format of files produced by compatible with the format of files produced by
:manpage:`sup-dump(1)`. So if you've previously been using sup :manpage:`sup-dump(1)`. So if you've previously been using sup
@ -77,18 +77,18 @@ Supported options for **dump** include
Control what kind of metadata is included in the output. Control what kind of metadata is included in the output.
**config** config
Output configuration data stored in the database. Each line Output configuration data stored in the database. Each line
starts with "#@ ", followed by a space separated key-value starts with "#@ ", followed by a space separated key-value
pair. Both key and value are hex encoded if needed. pair. Both key and value are hex encoded if needed.
**properties** properties
Output per-message (key,value) metadata. Each line starts Output per-message (key,value) metadata. Each line starts
with "#= ", followed by a message id, and a space separated with "#= ", followed by a message id, and a space separated
list of key=value pairs. Ids, keys and values are hex encoded list of key=value pairs. Ids, keys and values are hex encoded
if needed. See :any:`notmuch-properties(7)` for more details. if needed. See :any:`notmuch-properties(7)` for more details.
**tags** tags
Output per-message boolean metadata, namely tags. See *format* above Output per-message boolean metadata, namely tags. See *format* above
for description of the output. for description of the output.

View file

@ -40,22 +40,22 @@ Supported options for **reply** include
.. option:: --format=(default|json|sexp|headers-only) .. option:: --format=(default|json|sexp|headers-only)
**default** default
Includes subject and quoted message body as an RFC 2822 Includes subject and quoted message body as an RFC 2822
message. message.
**json** json
Produces JSON output containing headers for a reply message Produces JSON output containing headers for a reply message
and the contents of the original message. This output can be and the contents of the original message. This output can be
used by a client to create a reply message intelligently. used by a client to create a reply message intelligently.
**sexp** sexp
Produces S-Expression output containing headers for a reply Produces S-Expression output containing headers for a reply
message and the contents of the original message. This output message and the contents of the original message. This output
can be used by a client to create a reply message can be used by a client to create a reply message
intelligently. intelligently.
**headers-only** headers-only
Only produces In-Reply-To, References, To, Cc, and Bcc Only produces In-Reply-To, References, To, Cc, and Bcc
headers. headers.
@ -67,10 +67,10 @@ Supported options for **reply** include
.. option:: --reply-to=(all|sender) .. option:: --reply-to=(all|sender)
**all** (default) all (default)
Replies to all addresses. Replies to all addresses.
**sender** sender
Replies only to the sender. If replying to user's own message Replies only to the sender. If replying to user's own message
(Reply-to: or From: header is one of the user's configured (Reply-to: or From: header is one of the user's configured
email addresses), try To:, Cc:, and Bcc: headers in this email addresses), try To:, Cc:, and Bcc: headers in this

View file

@ -32,14 +32,14 @@ Supported options for **restore** include
line specifying a message-id and a set of tags. For details of the line specifying a message-id and a set of tags. For details of the
actual formats, see :any:`notmuch-dump(1)`. actual formats, see :any:`notmuch-dump(1)`.
**sup** sup
The **sup** dump file format is specifically chosen to be The **sup** dump file format is specifically chosen to be
compatible with the format of files produced by sup-dump. So compatible with the format of files produced by sup-dump. So
if you've previously been using sup for mail, then the if you've previously been using sup for mail, then the
**notmuch restore** command provides you a way to import all **notmuch restore** command provides you a way to import all
of your tags (or labels as sup calls them). of your tags (or labels as sup calls them).
**batch-tag** batch-tag
The **batch-tag** dump format is intended to more robust The **batch-tag** dump format is intended to more robust
against malformed message-ids and tags containing whitespace against malformed message-ids and tags containing whitespace
or non-\ **ascii(7)** characters. See :any:`notmuch-dump(1)` for or non-\ **ascii(7)** characters. See :any:`notmuch-dump(1)` for
@ -49,7 +49,7 @@ Supported options for **restore** include
changes if the **maildir.synchronize\_flags** configuration changes if the **maildir.synchronize\_flags** configuration
option is enabled. See :any:`notmuch-config(1)` for details. option is enabled. See :any:`notmuch-config(1)` for details.
**auto** auto
This option (the default) tries to guess the format from the This option (the default) tries to guess the format from the
input. For correctly formed input in either supported format, input. For correctly formed input in either supported format,
this heuristic, based the fact that batch-tag format contains this heuristic, based the fact that batch-tag format contains
@ -59,18 +59,18 @@ Supported options for **restore** include
Control what kind of metadata is restored. Control what kind of metadata is restored.
**config** config
Restore configuration data to the database. Each configuration Restore configuration data to the database. Each configuration
line starts with "#@ ", followed by a space separated line starts with "#@ ", followed by a space separated
key-value pair. Both key and value are hex encoded if needed. key-value pair. Both key and value are hex encoded if needed.
**properties** properties
Restore per-message (key,value) metadata. Each line starts Restore per-message (key,value) metadata. Each line starts
with "#= ", followed by a message id, and a space separated with "#= ", followed by a message id, and a space separated
list of key=value pairs. Ids, keys and values are hex encoded list of key=value pairs. Ids, keys and values are hex encoded
if needed. See :any:`notmuch-properties(7)` for more details. if needed. See :any:`notmuch-properties(7)` for more details.
**tags** tags
Restore per-message metadata, namely tags. See *format* above Restore per-message metadata, namely tags. See *format* above
for more details. for more details.

View file

@ -43,7 +43,7 @@ Supported options for **search** include
.. option:: --output=(summary|threads|messages|files|tags) .. option:: --output=(summary|threads|messages|files|tags)
**summary** summary
Output a summary of each thread with any message matching the Output a summary of each thread with any message matching the
search terms. The summary includes the thread ID, date, the search terms. The summary includes the thread ID, date, the
number of messages in the thread (both the number matched and number of messages in the thread (both the number matched and
@ -52,19 +52,19 @@ Supported options for **search** include
for some messages, the total number of files is printed in for some messages, the total number of files is printed in
parentheses (see below for an example). parentheses (see below for an example).
**threads** threads
Output the thread IDs of all threads with any message matching Output the thread IDs of all threads with any message matching
the search terms, either one per line (``--format=text``), the search terms, either one per line (``--format=text``),
separated by null characters (``--format=text0``), as a JSON array separated by null characters (``--format=text0``), as a JSON array
(``--format=json``), or an S-Expression list (``--format=sexp``). (``--format=json``), or an S-Expression list (``--format=sexp``).
**messages** messages
Output the message IDs of all messages matching the search Output the message IDs of all messages matching the search
terms, either one per line (``--format=text``), separated by null terms, either one per line (``--format=text``), separated by null
characters (``--format=text0``), as a JSON array (``--format=json``), characters (``--format=text0``), as a JSON array (``--format=json``),
or as an S-Expression list (``--format=sexp``). or as an S-Expression list (``--format=sexp``).
**files** files
Output the filenames of all messages matching the search Output the filenames of all messages matching the search
terms, either one per line (``--format=text``), separated by null terms, either one per line (``--format=text``), separated by null
characters (``--format=text0``), as a JSON array (``--format=json``), characters (``--format=text0``), as a JSON array (``--format=json``),
@ -78,7 +78,7 @@ Supported options for **search** include
in other directories that are included in the output, although in other directories that are included in the output, although
these files alone would not match the search. these files alone would not match the search.
**tags** tags
Output all tags that appear on any message matching the search Output all tags that appear on any message matching the search
terms, either one per line (``--format=text``), separated by null terms, either one per line (``--format=text``), separated by null
characters (``--format=text0``), as a JSON array (``--format=json``), characters (``--format=text0``), as a JSON array (``--format=json``),
@ -115,20 +115,20 @@ Supported options for **search** include
terms. This option specifies whether to omit excluded messages in terms. This option specifies whether to omit excluded messages in
the search process. the search process.
**true** (default) true (default)
Prevent excluded messages from matching the search terms. Prevent excluded messages from matching the search terms.
**all** all
Additionally prevent excluded messages from appearing in Additionally prevent excluded messages from appearing in
displayed results, in effect behaving as though the excluded displayed results, in effect behaving as though the excluded
messages do not exist. messages do not exist.
**false** false
Allow excluded messages to match search terms and appear in Allow excluded messages to match search terms and appear in
displayed results. Excluded messages are still marked in the displayed results. Excluded messages are still marked in the
relevant outputs. relevant outputs.
**flag** flag
Only has an effect when ``--output=summary``. The output is Only has an effect when ``--output=summary``. The output is
almost identical to **false**, but the "match count" is the almost identical to **false**, but the "match count" is the
number of matching non-excluded messages in the thread, rather number of matching non-excluded messages in the thread, rather

View file

@ -36,7 +36,7 @@ Supported options for **show** include
.. option:: --format=(text|json|sexp|mbox|raw) .. option:: --format=(text|json|sexp|mbox|raw)
**text** (default for messages) text (default for messages)
The default plain-text format has all text-content MIME parts The default plain-text format has all text-content MIME parts
decoded. Various components in the output, (**message**, decoded. Various components in the output, (**message**,
**header**, **body**, **attachment**, and MIME **part**), will **header**, **body**, **attachment**, and MIME **part**), will
@ -46,7 +46,7 @@ Supported options for **show** include
'}'), to either open or close the component. For a multipart '}'), to either open or close the component. For a multipart
MIME message, these parts will be nested. MIME message, these parts will be nested.
**json** json
The output is formatted with Javascript Object Notation The output is formatted with Javascript Object Notation
(JSON). This format is more robust than the text format for (JSON). This format is more robust than the text format for
automated processing. The nested structure of multipart MIME automated processing. The nested structure of multipart MIME
@ -58,7 +58,7 @@ Supported options for **show** include
as UTF-8 and any message content included in the output will as UTF-8 and any message content included in the output will
be charset-converted to UTF-8. be charset-converted to UTF-8.
**sexp** sexp
The output is formatted as the Lisp s-expression (sexp) The output is formatted as the Lisp s-expression (sexp)
equivalent of the JSON format above. Objects are formatted as equivalent of the JSON format above. Objects are formatted as
property lists whose keys are keywords (symbols preceded by a property lists whose keys are keywords (symbols preceded by a
@ -66,7 +66,7 @@ Supported options for **show** include
formatted as ``nil``. As for JSON, the s-expression output is formatted as ``nil``. As for JSON, the s-expression output is
always encoded as UTF-8. always encoded as UTF-8.
**mbox** mbox
All matching messages are output in the traditional, Unix mbox All matching messages are output in the traditional, Unix mbox
format with each message being prefixed by a line beginning format with each message being prefixed by a line beginning
with "From " and a blank line separating each message. Lines with "From " and a blank line separating each message. Lines
@ -77,7 +77,7 @@ Supported options for **show** include
http://homepage.ntlworld.com/jonathan.deboynepollard/FGA/mail-mbox-formats.html http://homepage.ntlworld.com/jonathan.deboynepollard/FGA/mail-mbox-formats.html
**raw** (default if ``--part`` is given) raw (default if ``--part`` is given)
Write the raw bytes of the given MIME part of a message to Write the raw bytes of the given MIME part of a message to
standard out. For this format, it is an error to specify a standard out. For this format, it is an error to specify a
query that matches more than one message. query that matches more than one message.

View file

@ -19,7 +19,7 @@ must have executable permissions.
The currently available hooks are described below. The currently available hooks are described below.
**pre-new** pre-new
This hook is invoked by the :any:`notmuch-new(1)` command before This hook is invoked by the :any:`notmuch-new(1)` command before
scanning or importing new messages into the database. If this hook scanning or importing new messages into the database. If this hook
exits with a non-zero status, notmuch will abort further exits with a non-zero status, notmuch will abort further
@ -28,7 +28,7 @@ The currently available hooks are described below.
Typically this hook is used for fetching or delivering new mail to Typically this hook is used for fetching or delivering new mail to
be imported into the database. be imported into the database.
**post-new** post-new
This hook is invoked by the :any:`notmuch-new(1)` command after This hook is invoked by the :any:`notmuch-new(1)` command after
new messages have been imported into the database and initial tags new messages have been imported into the database and initial tags
have been applied. The hook will not be run if there have been any have been applied. The hook will not be run if there have been any
@ -37,7 +37,7 @@ The currently available hooks are described below.
Typically this hook is used to perform additional query-based Typically this hook is used to perform additional query-based
tagging on the imported messages. tagging on the imported messages.
**post-insert** post-insert
This hook is invoked by the :any:`notmuch-insert(1)` command after This hook is invoked by the :any:`notmuch-insert(1)` command after
the message has been delivered, added to the database, and initial the message has been delivered, added to the database, and initial
tags have been applied. The hook will not be run if there have tags have been applied. The hook will not be run if there have

View file

@ -55,7 +55,7 @@ MESSAGE PROPERTIES
The following properties are set by notmuch internally in the course The following properties are set by notmuch internally in the course
of its normal activity. of its normal activity.
**index.decryption** index.decryption
If a message contains encrypted content, and notmuch tries to If a message contains encrypted content, and notmuch tries to
decrypt that content during indexing, it will add the property decrypt that content during indexing, it will add the property
``index.decryption=success`` when the cleartext was successfully ``index.decryption=success`` when the cleartext was successfully
@ -75,8 +75,7 @@ of its normal activity.
:any:`notmuch-config(1)`), then this property will not be set on that :any:`notmuch-config(1)`), then this property will not be set on that
message. message.
**session-key** session-key
When :any:`notmuch-show(1)` or :any:`notmuch-reply(1)` encounters When :any:`notmuch-show(1)` or :any:`notmuch-reply(1)` encounters
a message with an encrypted part, if notmuch finds a a message with an encrypted part, if notmuch finds a
``session-key`` property associated with the message, it will try ``session-key`` property associated with the message, it will try
@ -111,8 +110,7 @@ of its normal activity.
example, an AES-128 key might be stashed in a notmuch property as: example, an AES-128 key might be stashed in a notmuch property as:
``session-key=7:14B16AF65536C28AF209828DFE34C9E0``. ``session-key=7:14B16AF65536C28AF209828DFE34C9E0``.
**index.repaired** index.repaired
Some messages arrive in forms that are confusing to view; they can Some messages arrive in forms that are confusing to view; they can
be mangled by mail transport agents, or the sending mail user be mangled by mail transport agents, or the sending mail user
agent may structure them in a way that is confusing. If notmuch agent may structure them in a way that is confusing. If notmuch