Re: [PATCH v2 3/7] man: document notmuch search --duplicate=N
authorJani Nikula <jani@nikula.org>
Mon, 10 Jun 2013 16:39:34 +0000 (19:39 +0300)
committerW. Trevor King <wking@tremily.us>
Fri, 7 Nov 2014 17:55:33 +0000 (09:55 -0800)
c0/ca901bda097ca0836f6c12f6e05a13511ab93c [new file with mode: 0644]

diff --git a/c0/ca901bda097ca0836f6c12f6e05a13511ab93c b/c0/ca901bda097ca0836f6c12f6e05a13511ab93c
new file mode 100644 (file)
index 0000000..f274ec3
--- /dev/null
@@ -0,0 +1,150 @@
+Return-Path: <jani@nikula.org>\r
+X-Original-To: notmuch@notmuchmail.org\r
+Delivered-To: notmuch@notmuchmail.org\r
+Received: from localhost (localhost [127.0.0.1])\r
+       by olra.theworths.org (Postfix) with ESMTP id 14867431FB6\r
+       for <notmuch@notmuchmail.org>; Mon, 10 Jun 2013 09:39:49 -0700 (PDT)\r
+X-Virus-Scanned: Debian amavisd-new at olra.theworths.org\r
+X-Spam-Flag: NO\r
+X-Spam-Score: -0.7\r
+X-Spam-Level: \r
+X-Spam-Status: No, score=-0.7 tagged_above=-999 required=5\r
+       tests=[RCVD_IN_DNSWL_LOW=-0.7] autolearn=disabled\r
+Received: from olra.theworths.org ([127.0.0.1])\r
+       by localhost (olra.theworths.org [127.0.0.1]) (amavisd-new, port 10024)\r
+       with ESMTP id beMh79LmWSV6 for <notmuch@notmuchmail.org>;\r
+       Mon, 10 Jun 2013 09:39:41 -0700 (PDT)\r
+Received: from mail-lb0-f174.google.com (mail-lb0-f174.google.com\r
+       [209.85.217.174]) (using TLSv1 with cipher RC4-SHA (128/128 bits))\r
+       (No client certificate requested)\r
+       by olra.theworths.org (Postfix) with ESMTPS id 1E7EB431FC4\r
+       for <notmuch@notmuchmail.org>; Mon, 10 Jun 2013 09:39:40 -0700 (PDT)\r
+Received: by mail-lb0-f174.google.com with SMTP id x10so4416909lbi.5\r
+       for <notmuch@notmuchmail.org>; Mon, 10 Jun 2013 09:39:39 -0700 (PDT)\r
+X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;\r
+       d=google.com; s=20120113;\r
+       h=from:to:subject:in-reply-to:references:user-agent:date:message-id\r
+       :mime-version:content-type:x-gm-message-state;\r
+       bh=cMhtioo8v/skrxMl3USFC8m7JX+tfF+XvdQ2+7Vz6WM=;\r
+       b=G3j4eenHFR+PR2zQnNkQple88/2b1zpduIF6Z7xF7mAx1a32+/NoTboqZZshT5u53j\r
+       UiWR/Y53jNvUac3KEPREnH6xB14NOTyO9wnqvx/OHuzPcvxPQnkLxZFjOwcYYuMldijE\r
+       OiQO06A8fitgmounoWdVt3zTL3HrpsqLICbjw1Rq3kVOwal6bZAQzRpHRIQoWGr2YqAn\r
+       TuBpe2T7/cf8MiBHbNEcBrOX3eeRZ+yTkq+WAObqJ6surJEDHoXPr6Pu58iIgLS6WcZg\r
+       h7ERzYi6rKsWM/r3f8tHLCU4X/4yrBSIWBQZHcg22b5uncEef4SIEqHYqHe/cwIA7RhI\r
+       /hsA==\r
+X-Received: by 10.152.121.106 with SMTP id lj10mr5404734lab.27.1370882379596; \r
+       Mon, 10 Jun 2013 09:39:39 -0700 (PDT)\r
+Received: from localhost (dsl-hkibrasgw2-58c376-211.dhcp.inet.fi.\r
+       [88.195.118.211])\r
+       by mx.google.com with ESMTPSA id x3sm4742906lag.6.2013.06.10.09.39.38\r
+       for <multiple recipients>\r
+       (version=TLSv1.2 cipher=RC4-SHA bits=128/128);\r
+       Mon, 10 Jun 2013 09:39:38 -0700 (PDT)\r
+From: Jani Nikula <jani@nikula.org>\r
+To: Mark Walters <markwalters1009@gmail.com>, notmuch@notmuchmail.org\r
+Subject: Re: [PATCH v2 3/7] man: document notmuch search --duplicate=N\r
+In-Reply-To: <87bo7fo1p9.fsf@qmul.ac.uk>\r
+References: <cover.1370775663.git.jani@nikula.org>\r
+       <e72d722da8706559142fcb3ea2626990b39192c5.1370775663.git.jani@nikula.org>\r
+       <87ehcbo1yf.fsf@qmul.ac.uk> <87bo7fo1p9.fsf@qmul.ac.uk>\r
+User-Agent: Notmuch/0.15.2+179~g8952790 (http://notmuchmail.org) Emacs/24.3.1\r
+       (x86_64-pc-linux-gnu)\r
+Date: Mon, 10 Jun 2013 19:39:34 +0300\r
+Message-ID: <87txl56htl.fsf@nikula.org>\r
+MIME-Version: 1.0\r
+Content-Type: text/plain\r
+X-Gm-Message-State:\r
+ ALoCoQmzsq/6+Fbg5phQTpWkecJwfpIP+xOhUSmRSihIRcV01qvzWqgndUw143DGsXBxMc+KrxXQ\r
+X-BeenThere: notmuch@notmuchmail.org\r
+X-Mailman-Version: 2.1.13\r
+Precedence: list\r
+List-Id: "Use and development of the notmuch mail system."\r
+       <notmuch.notmuchmail.org>\r
+List-Unsubscribe: <http://notmuchmail.org/mailman/options/notmuch>,\r
+       <mailto:notmuch-request@notmuchmail.org?subject=unsubscribe>\r
+List-Archive: <http://notmuchmail.org/pipermail/notmuch>\r
+List-Post: <mailto:notmuch@notmuchmail.org>\r
+List-Help: <mailto:notmuch-request@notmuchmail.org?subject=help>\r
+List-Subscribe: <http://notmuchmail.org/mailman/listinfo/notmuch>,\r
+       <mailto:notmuch-request@notmuchmail.org?subject=subscribe>\r
+X-List-Received-Date: Mon, 10 Jun 2013 16:39:49 -0000\r
+\r
+On Sun, 09 Jun 2013, Mark Walters <markwalters1009@gmail.com> wrote:\r
+> Sorry about that: I meant to cancel the message rather than sending it.\r
+>\r
+> What I was wondering was whether we should change the wording of the\r
+> manpage to make it clear that notmuch search --output=files returns all\r
+> filenames where any of the copies matches the search terms (I think; I\r
+> was going to check before sending anything). In particular, \r
+>\r
+> notmuch search --output=files folder:a_folder may return filenames not\r
+> in a_folder\r
+>\r
+> (This is slightly more noticeable with this patch than before as \r
+> notmuch search --output=files --duplicate=1 folder:a_folder could give\r
+> no results in folder a_folder\r
+>\r
+> (None of the above is meant to be a criticism of this patch: I have\r
+> only sent this email due to my accidental sending of the previous message)\r
+\r
+No worries, it's a valid point. I tried to address them in the updated\r
+man page for --duplicate=N [1], and in an update to the search terms man\r
+page [2].\r
+\r
+BR,\r
+Jani.\r
+\r
+[1] id:1370881714-3303-1-git-send-email-jani@nikula.org\r
+[2] id:1370881897-3386-1-git-send-email-jani@nikula.org\r
+\r
+\r
+>\r
+> Best wishes\r
+>\r
+> Mark\r
+>\r
+>\r
+>\r
+>\r
+> What IOn Sun, 09 Jun 2013, Mark Walters <markwalters1009@gmail.com> wrote:\r
+>> One thing that slightly bothers me with this set (which in some sense is\r
+>> already true) is doing a search of the form\r
+>>\r
+>> notmuch search --output=files folder:<a_folder>\r
+>>\r
+>> T\r
+>>\r
+>> On Sun, 09 Jun 2013, Jani Nikula <jani@nikula.org> wrote:\r
+>>> ---\r
+>>>  man/man1/notmuch-search.1 |   11 +++++++++++\r
+>>>  1 file changed, 11 insertions(+)\r
+>>>\r
+>>> diff --git a/man/man1/notmuch-search.1 b/man/man1/notmuch-search.1\r
+>>> index 1c1e049..4d8b3d3 100644\r
+>>> --- a/man/man1/notmuch-search.1\r
+>>> +++ b/man/man1/notmuch-search.1\r
+>>> @@ -158,6 +158,17 @@ but the "match count" is the number of matching non-excluded messages in the\r
+>>>  thread, rather than the number of matching messages.\r
+>>>  .RE\r
+>>>  \r
+>>> +.RS 4\r
+>>> +.TP 4\r
+>>> +.BR \-\-duplicate=N\r
+>>> +\r
+>>> +Effective with\r
+>>> +.BR --output=files ,\r
+>>> +output the Nth filename associated with each message matching the\r
+>>> +query (N is 1-based). If N is greater than the number of files\r
+>>> +associated with the message, don't print anything.\r
+>>> +.RE\r
+>>> +\r
+>>>  .SH EXIT STATUS\r
+>>>  \r
+>>>  This command supports the following special exit status codes\r
+>>> -- \r
+>>> 1.7.10.4\r
+>>>\r
+>>> _______________________________________________\r
+>>> notmuch mailing list\r
+>>> notmuch@notmuchmail.org\r
+>>> http://notmuchmail.org/mailman/listinfo/notmuch\r