a9/2379defe74d7df0d63a8220db10f41789c62cc

   1 Return-Path: <sshilovsky@gmail.com>\r
   2 X-Original-To: notmuch@notmuchmail.org\r
   3 Delivered-To: notmuch@notmuchmail.org\r
   4 Received: from localhost (localhost [127.0.0.1])\r
   5         by olra.theworths.org (Postfix) with ESMTP id 0D192431FB6\r
   6         for <notmuch@notmuchmail.org>; Tue, 14 Oct 2014 07:50:34 -0700 (PDT)\r
   7 X-Virus-Scanned: Debian amavisd-new at olra.theworths.org\r
   8 X-Spam-Flag: NO\r
   9 X-Spam-Score: -0.799\r
  10 X-Spam-Level: \r
  11 X-Spam-Status: No, score=-0.799 tagged_above=-999 required=5\r
  12         tests=[DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1,\r
  13         FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_LOW=-0.7] autolearn=disabled\r
  14 Received: from olra.theworths.org ([127.0.0.1])\r
  15         by localhost (olra.theworths.org [127.0.0.1]) (amavisd-new, port 10024)\r
  16         with ESMTP id 3Lx0KuvdZQNP for <notmuch@notmuchmail.org>;\r
  17         Tue, 14 Oct 2014 07:50:29 -0700 (PDT)\r
  18 Received: from mail-lb0-f172.google.com (mail-lb0-f172.google.com\r
  19         [209.85.217.172]) (using TLSv1 with cipher RC4-SHA (128/128 bits))\r
  20         (No client certificate requested)\r
  21         by olra.theworths.org (Postfix) with ESMTPS id 69D4F431FBD\r
  22         for <notmuch@notmuchmail.org>; Tue, 14 Oct 2014 07:50:29 -0700 (PDT)\r
  23 Received: by mail-lb0-f172.google.com with SMTP id b6so8385780lbj.17\r
  24         for <notmuch@notmuchmail.org>; Tue, 14 Oct 2014 07:50:27 -0700 (PDT)\r
  25 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113;\r
  26         h=from:to:cc:subject:date:message-id:in-reply-to:references;\r
  27         bh=eAI7N8poDF3PIMrCDz3rVjDG+OyawBHlqYfQzzyavUA=;\r
  28         b=tm+ZyPx3Iuvub3iragIRJLOWwZ9bNMB9LdWaqdg71FAZx8IEH7wvQS4NyuTJtNiXO8\r
  29         3pzaOtePlbw/1zsq1YJYFwLJr1RMXwV/zDxdtilaSxkXkeON9xze579IgancDlvNO/9q\r
  30         jbHYy3jsroFQ4FVRMzTxh/9MgV67hBbAW96tRQokv4R5WHzwQg9/SzAf403D7Wvkfrlr\r
  31         Ew0OT9u5NoW2DphxjtpZ0Y4Z6GliDyrxt2wODkzmDxiz5tEWWEWjBX+62F4TQqEr4/5k\r
  32         yaz03V+z9pP5DhVmXDTOAvU81k2Y8dqA4MhwLAXj4T7vr7bVUthfUiL3y1Xd++vxb6yq\r
  33         6AMA==\r
  34 X-Received: by 10.112.48.3 with SMTP id h3mr5825852lbn.71.1413298227589;\r
  35         Tue, 14 Oct 2014 07:50:27 -0700 (PDT)\r
  36 Received: from localhost (shpd-178-69-250-75.vologda.ru. [178.69.250.75])\r
  37         by mx.google.com with ESMTPSA id w10sm806201lae.24.2014.10.14.07.50.26\r
  38         for <multiple recipients>\r
  39         (version=TLSv1.2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128);\r
  40         Tue, 14 Oct 2014 07:50:26 -0700 (PDT)\r
  41 From: Sergei Shilovsky <sshilovsky@gmail.com>\r
  42 To: notmuch@notmuchmail.org\r
  43 Subject: [PATCH] man: add notes about issues with notmuch-count\r
  44 Date: Tue, 14 Oct 2014 18:48:32 +0400\r
  45 Message-Id: <1413298112-19912-2-git-send-email-sshilovsky@gmail.com>\r
  46 X-Mailer: git-send-email 2.1.0\r
  47 In-Reply-To: <1413298112-19912-1-git-send-email-sshilovsky@gmail.com>\r
  48 References: <1413298112-19912-1-git-send-email-sshilovsky@gmail.com>\r
  49 X-BeenThere: notmuch@notmuchmail.org\r
  50 X-Mailman-Version: 2.1.13\r
  51 Precedence: list\r
  52 List-Id: "Use and development of the notmuch mail system."\r
  53         <notmuch.notmuchmail.org>\r
  54 List-Unsubscribe: <http://notmuchmail.org/mailman/options/notmuch>,\r
  55         <mailto:notmuch-request@notmuchmail.org?subject=unsubscribe>\r
  56 List-Archive: <http://notmuchmail.org/pipermail/notmuch>\r
  57 List-Post: <mailto:notmuch@notmuchmail.org>\r
  58 List-Help: <mailto:notmuch-request@notmuchmail.org?subject=help>\r
  59 List-Subscribe: <http://notmuchmail.org/mailman/listinfo/notmuch>,\r
  60         <mailto:notmuch-request@notmuchmail.org?subject=subscribe>\r
  61 X-List-Received-Date: Tue, 14 Oct 2014 14:50:34 -0000\r
  62 \r
  63 1. notmuch count --output=messages outputs estimated number\r
  64 \r
  65 2. notmuch count --output=(files|threads) can be slow\r
  66 ---\r
  67  doc/man1/notmuch-count.rst | 14 +++++++++-----\r
  68  1 file changed, 9 insertions(+), 5 deletions(-)\r
  69 \r
  70 diff --git a/doc/man1/notmuch-count.rst b/doc/man1/notmuch-count.rst\r
  71 index ca78c18..3bb6981 100644\r
  72 --- a/doc/man1/notmuch-count.rst\r
  73 +++ b/doc/man1/notmuch-count.rst\r
  74 @@ -10,7 +10,7 @@ SYNOPSIS\r
  75  DESCRIPTION\r
  76  ===========\r
  77  \r
  78 -Count messages matching the search terms.\r
  79 +Count (an estimate of) the number of messages matching the search terms.\r
  80  \r
  81  The number of matching messages (or threads) is output to stdout.\r
  82  \r
  83 @@ -25,16 +25,20 @@ Supported options for **count** include\r
  84      ``--output=(messages|threads|files)``\r
  85  \r
  86          **messages**\r
  87 -            Output the number of matching messages. This is the default.\r
  88 +            Output an estimate of the number of matching messages. This is the\r
  89 +            default.\r
  90  \r
  91          **threads**\r
  92 -            Output the number of matching threads.\r
  93 +            Output the exact number of matching threads. The search is\r
  94 +            performed, so this is a significantly heavier operation than\r
  95 +            ``--output=messages``.\r
  96  \r
  97          **files**\r
  98 -            Output the number of files associated with matching\r
  99 +            Output the exact number of files associated with matching\r
 100              messages. This may be bigger than the number of matching\r
 101              messages due to duplicates (i.e. multiple files having the\r
 102 -            same message-id).\r
 103 +            same message-id). The search is performed, so this is a\r
 104 +            significantly heavier operation than ``--output=messages``.\r
 105  \r
 106      ``--exclude=(true|false)``\r
 107          Specify whether to omit messages matching search.tag\_exclude\r
 108 -- \r
 109 2.1.0\r
 110 \r