1. notmuch count --output=messages outputs estimated number

2. notmuch count --output=(files|threads) can be slow
---
 doc/man1/notmuch-count.rst | 14 +++++++++-----
 1 file changed, 9 insertions(+), 5 deletions(-)

diff --git a/doc/man1/notmuch-count.rst b/doc/man1/notmuch-count.rst
index ca78c18..3bb6981 100644
--- a/doc/man1/notmuch-count.rst
+++ b/doc/man1/notmuch-count.rst
@@ -10,7 +10,7 @@ SYNOPSIS
 DESCRIPTION
 ===========

-Count messages matching the search terms.
+Count (an estimate of) the number of messages matching the search terms.

 The number of matching messages (or threads) is output to stdout.

@@ -25,16 +25,20 @@ Supported options for **count** include
     ``--output=(messages|threads|files)``

         **messages**
-            Output the number of matching messages. This is the default.
+            Output an estimate of the number of matching messages. This is the
+            default.

         **threads**
-            Output the number of matching threads.
+            Output the exact number of matching threads. The search is
+            performed, so this is a significantly heavier operation than
+            ``--output=messages``.

         **files**
-            Output the number of files associated with matching
+            Output the exact number of files associated with matching
             messages. This may be bigger than the number of matching
             messages due to duplicates (i.e. multiple files having the
-            same message-id).
+            same message-id). The search is performed, so this is a
+            significantly heavier operation than ``--output=messages``.

     ``--exclude=(true|false)``
         Specify whether to omit messages matching search.tag\_exclude
-- 
2.1.0

Reply via email to