(--format=json), or as an S-Expression list (--format=sexp).
Note that each message may have multiple filenames
- associated with it. All of them are included in the output,
- unless limited with the --duplicate=N option.
+ associated with it. All of them are included in the output
+ (unless limited with the --duplicate=N option). This may
+ be particularly confusing for **folder:** or **path:**
+ searches in a specified directory, as the messages may
+ have duplicates in other directories that are included in
+ the output, although these files alone would not match the
+ search.
**tags**
Output all tags that appear on any message matching the
rather than the number of matching messages.
``--duplicate=N``
- Effective with ``--output=files``, output the Nth filename
- associated with each message matching the query (N is 1-based).
- If N is greater than the number of files associated with the
- message, don't print anything.
+ For ``--output=files``, output the Nth filename associated
+ with each message matching the query (N is 1-based). If N is
+ greater than the number of files associated with the message,
+ don't print anything.
+
+ For ``--output=messages``, only output message IDs of messages
+ matching the search terms that have at least N filenames
+ associated with them.
Note that this option is orthogonal with the **folder:** search
prefix. The prefix matches messages based on filenames. This
**notmuch-dump(1)**, **notmuch-hooks(5)**, **notmuch-insert(1)**,
**notmuch-new(1)**, **notmuch-reply(1)**, **notmuch-restore(1)**,
**notmuch-search-terms(7)**, **notmuch-show(1)**, **notmuch-tag(1)**
+**notmuch-address(1)**