From 5348d1987cc34381aff94f64c577984de5788e6a Mon Sep 17 00:00:00 2001 From: Jani Nikula Date: Sat, 8 Feb 2014 23:14:25 +0200 Subject: [PATCH] man: try to clarify the folder: and path: vs. --output=files confusion --- 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 7ac6c68e..90160f21 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 -- 2.26.2