From: Mark Walters <markwalters1009@gmail.com>
To: Jani Nikula <jani@nikula.org>, notmuch@notmuchmail.org
Subject: Re: [PATCH v2 3/7] man: document notmuch search --duplicate=N
In-Reply-To: <87ehcbo1yf.fsf@qmul.ac.uk>
References: <cover.1370775663.git.jani@nikula.org>
	<e72d722da8706559142fcb3ea2626990b39192c5.1370775663.git.jani@nikula.org>
	<87ehcbo1yf.fsf@qmul.ac.uk>
User-Agent: Notmuch/0.15.2+171~ge2f30a2 (http://notmuchmail.org) Emacs/23.4.1
	(x86_64-pc-linux-gnu)
Date: Sun, 09 Jun 2013 14:25:54 +0100
Message-ID: <87bo7fo1p9.fsf@qmul.ac.uk>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Precedence: list


Sorry about that: I meant to cancel the message rather than sending it.

What I was wondering was whether we should change the wording of the
manpage to make it clear that notmuch search --output=files returns all
filenames where any of the copies matches the search terms (I think; I
was going to check before sending anything). In particular, 

notmuch search --output=files folder:a_folder may return filenames not
in a_folder

(This is slightly more noticeable with this patch than before as 
notmuch search --output=files --duplicate=1 folder:a_folder could give
no results in folder a_folder

(None of the above is meant to be a criticism of this patch: I have
only sent this email due to my accidental sending of the previous message)

Best wishes

Mark




What IOn Sun, 09 Jun 2013, Mark Walters <markwalters1009@gmail.com> wrote:
> One thing that slightly bothers me with this set (which in some sense is
> already true) is doing a search of the form
>
> notmuch search --output=files folder:<a_folder>
>
> T
>
> On Sun, 09 Jun 2013, Jani Nikula <jani@nikula.org> wrote:
>> ---
>>  man/man1/notmuch-search.1 |   11 +++++++++++
>>  1 file changed, 11 insertions(+)
>>
>> diff --git a/man/man1/notmuch-search.1 b/man/man1/notmuch-search.1
>> index 1c1e049..4d8b3d3 100644
>> --- a/man/man1/notmuch-search.1
>> +++ b/man/man1/notmuch-search.1
>> @@ -158,6 +158,17 @@ but the "match count" is the number of matching non-excluded messages in the
>>  thread, rather than the number of matching messages.
>>  .RE
>>  
>> +.RS 4
>> +.TP 4
>> +.BR \-\-duplicate=N
>> +
>> +Effective with
>> +.BR --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.
>> +.RE
>> +
>>  .SH EXIT STATUS
>>  
>>  This command supports the following special exit status codes
>> -- 
>> 1.7.10.4
>>
>> _______________________________________________
>> notmuch mailing list
>> notmuch@notmuchmail.org
>> http://notmuchmail.org/mailman/listinfo/notmuch