[PATCH v5] man: try to clarify the folder: and path: vs. --output=files confusion
Jani Nikula
jani at nikula.org
Sun Mar 9 23:26:09 PDT 2014
---
doc/man1/notmuch-search.rst | 9 +++++++--
1 file changed, 7 insertions(+), 2 deletions(-)
diff --git a/doc/man1/notmuch-search.rst b/doc/man1/notmuch-search.rst
index 7ac6c68e68ac..90160f21e23c 100644
--- a/doc/man1/notmuch-search.rst
+++ b/doc/man1/notmuch-search.rst
@@ -64,8 +64,13 @@ Supported options for **search** include
(--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
--
1.9.0
More information about the notmuch
mailing list