[PATCH v2 5/8] man: clarify search --exclude=flag

diff --git a/a7/4004096fafee0b43cffd8511f9331dee340861 b/a7/4004096fafee0b43cffd8511f9331dee340861
new file mode 100644 (file)
index 0000000..6767671
--- /dev/null
+++ b/a7/4004096fafee0b43cffd8511f9331dee340861
@@ -0,0 +1,93 @@
+Return-Path: <markwalters1009@gmail.com>\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 5DF23431FBC\r
+       for <notmuch@notmuchmail.org>; Sat, 11 May 2013 12:50:47 -0700 (PDT)\r
+X-Virus-Scanned: Debian amavisd-new at olra.theworths.org\r
+X-Spam-Flag: NO\r
+X-Spam-Score: 0.201\r
+X-Spam-Level: \r
+X-Spam-Status: No, score=0.201 tagged_above=-999 required=5\r
+       tests=[DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1,\r
+       FREEMAIL_ENVFROM_END_DIGIT=1, FREEMAIL_FROM=0.001,\r
+       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 2L573MPjN5Zl for <notmuch@notmuchmail.org>;\r
+       Sat, 11 May 2013 12:50:42 -0700 (PDT)\r
+Received: from mail-we0-f175.google.com (mail-we0-f175.google.com\r
+       [74.125.82.175]) (using TLSv1 with cipher RC4-SHA (128/128 bits))\r
+       (No client certificate requested)\r
+       by olra.theworths.org (Postfix) with ESMTPS id C5CDF431FD2\r
+       for <notmuch@notmuchmail.org>; Sat, 11 May 2013 12:50:27 -0700 (PDT)\r
+Received: by mail-we0-f175.google.com with SMTP id p57so5130462wes.34\r
+       for <notmuch@notmuchmail.org>; Sat, 11 May 2013 12:50:26 -0700 (PDT)\r
+DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113;\r
+       h=x-received:from:to:cc:subject:date:message-id:x-mailer:in-reply-to\r
+       :references; bh=Cm3pdvAvxoUhFHsOhVqpRJvbP5Vo8Rns/wIPWNLA8jk=;\r
+       b=SE73RCySvcUkvgRRoeGFpjCznZ7AVid8umTaevFQBnbboqhMQ68pYZtv+PArj/BLwA\r
+       uEmDggg4tRGlRGT0rJ7Ey3NzyIQb7Sd3LRCHUvP9uHIeyzIXMvkDeSKOk4Z7z47UuTNc\r
+       IKPlfxeO2i2cmpCCuht0IM3yPzwy05e3Los8qnOlmRTKp3EGT97OIkDS7y/xOo8IC9GC\r
+       GLzBNFjeWZH+XRmyC3uGZneedT6Bb5BeI6KrQhVEg5hywhQMuoCrV/5KS7JzUNJxA31P\r
+       /JOtuSkaEtIN/7gyetkqarWphYeYWuRyQRMr7rMhRLDwfUimhOI+41jsr5KVXVa0M435\r
+       Yj7Q==\r
+X-Received: by 10.180.90.70 with SMTP id bu6mr10343130wib.34.1368301826764;\r
+       Sat, 11 May 2013 12:50:26 -0700 (PDT)\r
+Received: from localhost (93-97-24-31.zone5.bethere.co.uk. [93.97.24.31])\r
+       by mx.google.com with ESMTPSA id\r
+       ff10sm6164309wib.10.2013.05.11.12.50.25 for <multiple recipients>\r
+       (version=TLSv1.2 cipher=RC4-SHA bits=128/128);\r
+       Sat, 11 May 2013 12:50:26 -0700 (PDT)\r
+From: Mark Walters <markwalters1009@gmail.com>\r
+To: notmuch@notmuchmail.org\r
+Subject: [PATCH v2 5/8] man: clarify search --exclude=flag\r
+Date: Sat, 11 May 2013 20:50:06 +0100\r
+Message-Id: <1368301809-12532-6-git-send-email-markwalters1009@gmail.com>\r
+X-Mailer: git-send-email 1.7.9.1\r
+In-Reply-To: <1368301809-12532-1-git-send-email-markwalters1009@gmail.com>\r
+References: <1368301809-12532-1-git-send-email-markwalters1009@gmail.com>\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: Sat, 11 May 2013 19:50:47 -0000\r
+\r
+From: Peter Wang <novalazy@gmail.com>\r
+\r
+Improve the description of the search --exclude=flag option,\r
+using text taken from the commit that introduced the option.\r
+---\r
+ man/man1/notmuch-search.1 |    8 +++++---\r
+ 1 files changed, 5 insertions(+), 3 deletions(-)\r
+\r
+diff --git a/man/man1/notmuch-search.1 b/man/man1/notmuch-search.1\r
+index 59e8f34..da2f1dd 100644\r
+--- a/man/man1/notmuch-search.1\r
++++ b/man/man1/notmuch-search.1\r
+@@ -147,9 +147,11 @@ results. Excluded messages are still marked in the relevant outputs.\r
+ \r
+ .B flag\r
+ only has an effect when\r
+-.B --output=summary\r
+-In this case all matching threads are returned but the "match count"\r
+-is the number of matching non-excluded messages in the thread.\r
++.BR --output=summary .\r
++The output is almost identical to\r
++.BR false ,\r
++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
+ .SH EXIT STATUS\r
+-- \r
+1.7.9.1\r
+\r