Re: [PATCH v2 4/9] man: document notmuch address --deduplicate=(no|mailbox) option

diff --git a/d6/15782b058fdde29dac7c62d6797d43dd8c5c0d b/d6/15782b058fdde29dac7c62d6797d43dd8c5c0d
new file mode 100644 (file)
index 0000000..c6978e0
--- /dev/null
+++ b/d6/15782b058fdde29dac7c62d6797d43dd8c5c0d
@@ -0,0 +1,81 @@
+Return-Path: <david@tethera.net>\r
+X-Original-To: notmuch@notmuchmail.org\r
+Delivered-To: notmuch@notmuchmail.org\r
+Received: from localhost (localhost [127.0.0.1])\r
+ by arlo.cworth.org (Postfix) with ESMTP id 0C7236DE157C\r
+ for <notmuch@notmuchmail.org>; Sun, 20 Sep 2015 06:46:08 -0700 (PDT)\r
+X-Virus-Scanned: Debian amavisd-new at cworth.org\r
+X-Spam-Flag: NO\r
+X-Spam-Score: 0.118\r
+X-Spam-Level: \r
+X-Spam-Status: No, score=0.118 tagged_above=-999 required=5 tests=[AWL=0.108, \r
+ T_FILL_THIS_FORM_SHORT=0.01] autolearn=disabled\r
+Received: from arlo.cworth.org ([127.0.0.1])\r
+ by localhost (arlo.cworth.org [127.0.0.1]) (amavisd-new, port 10024)\r
+ with ESMTP id KIRh4YwGz-r9 for <notmuch@notmuchmail.org>;\r
+ Sun, 20 Sep 2015 06:46:06 -0700 (PDT)\r
+Received: from gitolite.debian.net (gitolite.debian.net [87.98.215.224])\r
+ by arlo.cworth.org (Postfix) with ESMTPS id 0C1356DE1534\r
+ for <notmuch@notmuchmail.org>; Sun, 20 Sep 2015 06:46:05 -0700 (PDT)\r
+Received: from remotemail by gitolite.debian.net with local (Exim 4.80)\r
+ (envelope-from <david@tethera.net>)\r
+ id 1Zdek1-00072T-PJ; Sun, 20 Sep 2015 13:33:17 +0000\r
+Received: (nullmailer pid 4432 invoked by uid 1000); Sun, 20 Sep 2015\r
+ 12:45:51 -0000\r
+From: David Bremner <david@tethera.net>\r
+To: Jani Nikula <jani@nikula.org>, notmuch@notmuchmail.org\r
+Subject: Re: [PATCH v2 4/9] man: document notmuch address\r
+ --deduplicate=(no|mailbox) option\r
+In-Reply-To:\r
+ <ebc6d897c35212c28936158fc0509f8bdbebb48d.1441308761.git.jani@nikula.org>\r
+References: <cover.1441308761.git.jani@nikula.org>\r
+ <ebc6d897c35212c28936158fc0509f8bdbebb48d.1441308761.git.jani@nikula.org>\r
+User-Agent: Notmuch/0.20.2+73~gd432116 (http://notmuchmail.org) Emacs/24.5.1\r
+ (x86_64-pc-linux-gnu)\r
+Date: Sun, 20 Sep 2015 09:45:51 -0300\r
+Message-ID: <877fnltg1s.fsf@maritornes.cs.unb.ca>\r
+MIME-Version: 1.0\r
+Content-Type: text/plain\r
+X-BeenThere: notmuch@notmuchmail.org\r
+X-Mailman-Version: 2.1.18\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: Sun, 20 Sep 2015 13:46:08 -0000\r
+\r
+Jani Nikula <jani@nikula.org> writes:\r
+\r
+> Document the deduplication of results.\r
+> ---\r
+>  doc/man1/notmuch-address.rst | 15 +++++++++++++++\r
+>  1 file changed, 15 insertions(+)\r
+>\r
+> diff --git a/doc/man1/notmuch-address.rst b/doc/man1/notmuch-address.rst\r
+> index 9570095b23c8..4ae7395bce4d 100644\r
+> --- a/doc/man1/notmuch-address.rst\r
+> +++ b/doc/man1/notmuch-address.rst\r
+> @@ -55,6 +55,21 @@ Supported options for **address** include\r
+>              Note: With this option, addresses are printed only after\r
+>              the whole search is finished. This may take long time.\r
+>  \r
+> +    ``--deduplicate=(no|mailbox)``\r
+> +\r
+> +        Control the deduplication of results.\r
+> +\r
+> +        **none**\r
+> +            Output all occurences of addresses in the matching\r
+> +            messages. This is not applicable with --output=count.\r
+should be be **no**, I guess.\r
+> +\r
+> +        **mailbox**\r
+> +        Deduplicate addresses based on the full, case sensitive\r
+> +        name and email address, or mailbox. This is effectively\r
+> +        the same as piping the --deduplicate=no output to **sort |\r
+> +        uniq**, except for the order of results. This is the\r