X-Git-Url: https://git.cworth.org/git?a=blobdiff_plain;f=manpages%2Fnotmuch-search-1.mdwn;h=6ea3bab36c96cbbade398ff6627dba2e9126200e;hb=219490b75a85ca18d449168575a0c7538e71612e;hp=098d9be4d68cab58c032d150ed66ffe727c3dac2;hpb=716bcefd296e3ee39ff65e8ef89e671c9828191d;p=notmuch-wiki diff --git a/manpages/notmuch-search-1.mdwn b/manpages/notmuch-search-1.mdwn index 098d9be..6ea3bab 100644 --- a/manpages/notmuch-search-1.mdwn +++ b/manpages/notmuch-search-1.mdwn @@ -12,8 +12,8 @@

DESCRIPTION

-       Search  for  messages  matching  the given search terms, and display as
-       results the threads containing the matched messages.
+       Search for messages matching the given search terms, and display as re‐
+       sults the threads containing the matched messages.
 
        The output consists of one line per thread, giving  a  thread  ID,  the
        date  of  the  newest (or oldest, depending on the sort option) matched
@@ -26,16 +26,16 @@
 
        Supported options for search include
 
-       --format=(json|sexp|text|text0)
+       --format=(json|sexp|text|text0)
               Presents  the  results  in  either  JSON, S-Expressions, newline
               character separated plain-text (default), or null character sep‐
               arated  plain-text  (compatible  with  xargs(1)  -0 option where
               available).
 
        --format-version=N
-              Use the specified structured  output  format  version.  This  is
-              intended  for  programs  that  invoke  notmuch(1) internally. If
-              omitted, the latest supported version will be used.
+              Use the specified structured output format version. This is  in‐
+              tended  for programs that invoke notmuch(1) internally. If omit‐
+              ted, the latest supported version will be used.
 
        --output=(summary|threads|messages|files|tags)
 
@@ -46,8 +46,8 @@
                      ber  matched  and  the  total number), the authors of the
                      thread and the subject. In the case where a  thread  con‐
                      tains  multiple files for some messages, the total number
-                     of files is printed in  parentheses  (see  below  for  an
-                     example).
+                     of files is printed in parentheses (see below for an  ex‐
+                     ample).
 
               threads
                      Output  the  thread  IDs  of all threads with any message
@@ -59,8 +59,8 @@
               messages
                      Output  the  message  IDs  of  all  messages matching the
                      search terms, either one per line (--format=text),  sepa‐
-                     rated  by  null  characters  (--format=text0),  as a JSON
-                     array (--format=json), or as an S-Expression list (--for-
+                     rated  by null characters (--format=text0), as a JSON ar‐
+                     ray (--format=json), or as an S-Expression  list  (--for-
                      mat=sexp).
 
               files  Output  the filenames of all messages matching the search
@@ -79,17 +79,17 @@
 
               tags   Output  all  tags that appear on any message matching the
                      search terms, either one per line (--format=text),  sepa‐
-                     rated  by  null  characters  (--format=text0),  as a JSON
-                     array (--format=json), or as an S-Expression list (--for-
+                     rated  by null characters (--format=text0), as a JSON ar‐
+                     ray (--format=json), or as an S-Expression  list  (--for-
                      mat=sexp).
 
-       --sort=(newest-first|oldest-first)
+       --sort=(newest-first|oldest-first)
               This option can be used to present results in either chronologi‐
               cal order (oldest-first) or reverse  chronological  order  (new-
               est-first).
 
-              Note:  The  thread  order  will  be  distinct  between these two
-              options (beyond being simply reversed).  When  sorting  by  old-
+              Note:  The  thread  order will be distinct between these two op‐
+              tions (beyond being  simply  reversed).  When  sorting  by  old-
               est-first  the  threads  will be sorted by the oldest message in
               each thread, but when sorting by newest-first the  threads  will
               be sorted by the newest message in each thread.
@@ -110,12 +110,12 @@
               search  terms.  This  option  specifies whether to omit excluded
               messages in the search process.
 
-              true (default)
+              true (default)
                      Prevent excluded messages from matching the search terms.
 
               all    Additionally prevent excluded messages from appearing  in
-                     displayed  results,  in  effect  behaving  as  though the
-                     excluded messages do not exist.
+                     displayed  results,  in effect behaving as though the ex‐
+                     cluded messages do not exist.
 
               false  Allow excluded messages to match search terms and  appear
                      in  displayed results. Excluded messages are still marked
@@ -163,10 +163,10 @@
 
 

SEE ALSO

-       notmuch(1),  notmuch-config(1), notmuch-count(1), notmuch-dump(1), not‐
-       much-hooks(5),  notmuch-insert(1),  notmuch-new(1),   notmuch-reply(1),
-       notmuch-restore(1),   notmuch-search-terms(7),   notmuch-show(1),  not‐
-       much-tag(1) notmuch-address(1)
+       notmuch(1),   notmuch-address(1)  notmuch-config(1),  notmuch-count(1),
+       notmuch-dump(1), notmuch-hooks(5),  notmuch-insert(1),  notmuch-new(1),
+       notmuch-reply(1),   notmuch-restore(1),  notmuch-search-terms(7),  not‐
+       much-show(1), notmuch-tag(1)
 

AUTHOR

@@ -176,7 +176,7 @@

COPYRIGHT

-       2009-2019, Carl Worth and many others
+       2009-2022, Carl Worth and many others
 
-

0.29

+

0.35