Return-Path: <jani@nikula.org>
X-Original-To: notmuch@notmuchmail.org
Delivered-To: notmuch@notmuchmail.org
Received: from localhost (localhost [127.0.0.1])
	by olra.theworths.org (Postfix) with ESMTP id 14867431FB6
	for <notmuch@notmuchmail.org>; Mon, 10 Jun 2013 09:39:49 -0700 (PDT)
X-Virus-Scanned: Debian amavisd-new at olra.theworths.org
X-Spam-Flag: NO
X-Spam-Score: -0.7
X-Spam-Level: 
X-Spam-Status: No, score=-0.7 tagged_above=-999 required=5
	tests=[RCVD_IN_DNSWL_LOW=-0.7] autolearn=disabled
Received: from olra.theworths.org ([127.0.0.1])
	by localhost (olra.theworths.org [127.0.0.1]) (amavisd-new, port 10024)
	with ESMTP id beMh79LmWSV6 for <notmuch@notmuchmail.org>;
	Mon, 10 Jun 2013 09:39:41 -0700 (PDT)
Received: from mail-lb0-f174.google.com (mail-lb0-f174.google.com
	[209.85.217.174]) (using TLSv1 with cipher RC4-SHA (128/128 bits))
	(No client certificate requested)
	by olra.theworths.org (Postfix) with ESMTPS id 1E7EB431FC4
	for <notmuch@notmuchmail.org>; Mon, 10 Jun 2013 09:39:40 -0700 (PDT)
Received: by mail-lb0-f174.google.com with SMTP id x10so4416909lbi.5
	for <notmuch@notmuchmail.org>; Mon, 10 Jun 2013 09:39:39 -0700 (PDT)
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
	d=google.com; s=20120113;
	h=from:to:subject:in-reply-to:references:user-agent:date:message-id
	:mime-version:content-type:x-gm-message-state;
	bh=cMhtioo8v/skrxMl3USFC8m7JX+tfF+XvdQ2+7Vz6WM=;
	b=G3j4eenHFR+PR2zQnNkQple88/2b1zpduIF6Z7xF7mAx1a32+/NoTboqZZshT5u53j
	UiWR/Y53jNvUac3KEPREnH6xB14NOTyO9wnqvx/OHuzPcvxPQnkLxZFjOwcYYuMldijE
	OiQO06A8fitgmounoWdVt3zTL3HrpsqLICbjw1Rq3kVOwal6bZAQzRpHRIQoWGr2YqAn
	TuBpe2T7/cf8MiBHbNEcBrOX3eeRZ+yTkq+WAObqJ6surJEDHoXPr6Pu58iIgLS6WcZg
	h7ERzYi6rKsWM/r3f8tHLCU4X/4yrBSIWBQZHcg22b5uncEef4SIEqHYqHe/cwIA7RhI
	/hsA==
X-Received: by 10.152.121.106 with SMTP id lj10mr5404734lab.27.1370882379596; 
	Mon, 10 Jun 2013 09:39:39 -0700 (PDT)
Received: from localhost (dsl-hkibrasgw2-58c376-211.dhcp.inet.fi.
	[88.195.118.211])
	by mx.google.com with ESMTPSA id x3sm4742906lag.6.2013.06.10.09.39.38
	for <multiple recipients>
	(version=TLSv1.2 cipher=RC4-SHA bits=128/128);
	Mon, 10 Jun 2013 09:39:38 -0700 (PDT)
From: Jani Nikula <jani@nikula.org>
To: Mark Walters <markwalters1009@gmail.com>, notmuch@notmuchmail.org
Subject: Re: [PATCH v2 3/7] man: document notmuch search --duplicate=N
In-Reply-To: <87bo7fo1p9.fsf@qmul.ac.uk>
References: <cover.1370775663.git.jani@nikula.org>
	<e72d722da8706559142fcb3ea2626990b39192c5.1370775663.git.jani@nikula.org>
	<87ehcbo1yf.fsf@qmul.ac.uk> <87bo7fo1p9.fsf@qmul.ac.uk>
User-Agent: Notmuch/0.15.2+179~g8952790 (http://notmuchmail.org) Emacs/24.3.1
	(x86_64-pc-linux-gnu)
Date: Mon, 10 Jun 2013 19:39:34 +0300
Message-ID: <87txl56htl.fsf@nikula.org>
MIME-Version: 1.0
Content-Type: text/plain
X-Gm-Message-State:
 ALoCoQmzsq/6+Fbg5phQTpWkecJwfpIP+xOhUSmRSihIRcV01qvzWqgndUw143DGsXBxMc+KrxXQ
X-BeenThere: notmuch@notmuchmail.org
X-Mailman-Version: 2.1.13
Precedence: list
List-Id: "Use and development of the notmuch mail system."
	<notmuch.notmuchmail.org>
List-Unsubscribe: <http://notmuchmail.org/mailman/options/notmuch>,
	<mailto:notmuch-request@notmuchmail.org?subject=unsubscribe>
List-Archive: <http://notmuchmail.org/pipermail/notmuch>
List-Post: <mailto:notmuch@notmuchmail.org>
List-Help: <mailto:notmuch-request@notmuchmail.org?subject=help>
List-Subscribe: <http://notmuchmail.org/mailman/listinfo/notmuch>,
	<mailto:notmuch-request@notmuchmail.org?subject=subscribe>
X-List-Received-Date: Mon, 10 Jun 2013 16:39:49 -0000

On Sun, 09 Jun 2013, Mark Walters <markwalters1009@gmail.com> wrote:
> 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)

No worries, it's a valid point. I tried to address them in the updated
man page for --duplicate=N [1], and in an update to the search terms man
page [2].

BR,
Jani.

[1] id:1370881714-3303-1-git-send-email-jani@nikula.org
[2] id:1370881897-3386-1-git-send-email-jani@nikula.org


>
> 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