[PATCH v4 10/13] man: try to clarify the folder: and path: vs. --output=files confusion
Jani Nikula
jani at nikula.org
Sun Mar 9 14:40:31 PDT 2014
---
man/man1/notmuch-search.1 | 10 ++++++++--
1 file changed, 8 insertions(+), 2 deletions(-)
diff --git a/man/man1/notmuch-search.1 b/man/man1/notmuch-search.1
index 55a81e79fce4..a2b1ae43f411 100644
--- a/man/man1/notmuch-search.1
+++ b/man/man1/notmuch-search.1
@@ -82,8 +82,14 @@ one per line (\-\-format=text), separated by null characters
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.
+All of them are included in the output (unless limited with the
+\-\-duplicate=N option). This may be particularly confusing for
+.B folder:
+or
+.B 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.
.RE
.RS 4
.TP 4
--
1.9.0
More information about the notmuch
mailing list