From: Jani Nikula Date: Mon, 10 Jun 2013 16:39:34 +0000 (+0300) Subject: Re: [PATCH v2 3/7] man: document notmuch search --duplicate=N X-Git-Url: http://git.tremily.us/?a=commitdiff_plain;h=5d4d889667a11ef0c8c2ccf2d4e2227523f080f7;p=notmuch-archives.git Re: [PATCH v2 3/7] man: document notmuch search --duplicate=N --- diff --git a/c0/ca901bda097ca0836f6c12f6e05a13511ab93c b/c0/ca901bda097ca0836f6c12f6e05a13511ab93c new file mode 100644 index 000000000..f274ec3e0 --- /dev/null +++ b/c0/ca901bda097ca0836f6c12f6e05a13511ab93c @@ -0,0 +1,150 @@ +Return-Path: +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 ; 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 ; + 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 ; Mon, 10 Jun 2013 09:39:40 -0700 (PDT) +Received: by mail-lb0-f174.google.com with SMTP id x10so4416909lbi.5 + for ; 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 + (version=TLSv1.2 cipher=RC4-SHA bits=128/128); + Mon, 10 Jun 2013 09:39:38 -0700 (PDT) +From: Jani Nikula +To: Mark Walters , notmuch@notmuchmail.org +Subject: Re: [PATCH v2 3/7] man: document notmuch search --duplicate=N +In-Reply-To: <87bo7fo1p9.fsf@qmul.ac.uk> +References: + + <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." + +List-Unsubscribe: , + +List-Archive: +List-Post: +List-Help: +List-Subscribe: , + +X-List-Received-Date: Mon, 10 Jun 2013 16:39:49 -0000 + +On Sun, 09 Jun 2013, Mark Walters 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 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: +>> +>> T +>> +>> On Sun, 09 Jun 2013, Jani Nikula 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