X-Git-Url: https://git.notmuchmail.org/git?a=blobdiff_plain;f=doc%2Fman1%2Fnotmuch-search.rst;h=ed9ff4e5b96522751b056192bb7eabc5b0da75dd;hb=3d0fd40eb0eca54fd05460203ae754c63f633d69;hp=181058c6d7a19d156d0e9ca2e033b696153b5002;hpb=0c6ec8c5572755ec39ca92c43d3aa4e4aef3f81d;p=notmuch diff --git a/doc/man1/notmuch-search.rst b/doc/man1/notmuch-search.rst index 181058c6..ed9ff4e5 100644 --- a/doc/man1/notmuch-search.rst +++ b/doc/man1/notmuch-search.rst @@ -47,25 +47,25 @@ Supported options for **search** include **threads** Output the thread IDs of all threads with any message matching - the search terms, either one per line (--format=text), - separated by null characters (--format=text0), as a JSON array - (--format=json), or an S-Expression list (--format=sexp). + the search terms, either one per line (``--format=text``), + separated by null characters (``--format=text0``), as a JSON array + (``--format=json``), or an S-Expression list (``--format=sexp``). **messages** Output the message IDs of all messages matching the search - terms, either one per line (--format=text), separated by null - characters (--format=text0), as a JSON array (--format=json), - or as an S-Expression list (--format=sexp). + terms, either one per line (``--format=text``), separated by null + characters (``--format=text0``), as a JSON array (``--format=json``), + or as an S-Expression list (``--format=sexp``). **files** Output the filenames of all messages matching the search - terms, either one per line (--format=text), separated by null - characters (--format=text0), as a JSON array (--format=json), - or as an S-Expression list (--format=sexp). + terms, either one per line (``--format=text``), separated by null + characters (``--format=text0``), as a JSON array (``--format=json``), + or as an S-Expression list (``--format=sexp``). Note that each message may have multiple filenames associated with it. All of them are included in the output (unless - limited with the --duplicate=N option). This may be + limited with the ``--duplicate=N`` option). This may be particularly confusing for **folder:** or **path:** searches in a specified directory, as the messages may have duplicates in other directories that are included in the output, although @@ -73,9 +73,9 @@ Supported options for **search** include **tags** Output all tags that appear on any message matching the search - terms, either one per line (--format=text), separated by null - characters (--format=text0), as a JSON array (--format=json), - or as an S-Expression list (--format=sexp). + terms, either one per line (``--format=text``), separated by null + characters (``--format=text0``), as a JSON array (``--format=json``), + or as an S-Expression list (``--format=sexp``). ``--sort=``\ (**newest-first**\ \|\ **oldest-first**) This option can be used to present results in either chronological @@ -100,7 +100,7 @@ Supported options for **search** include ``--exclude=(true|false|all|flag)`` A message is called "excluded" if it matches at least one tag in - search.tag\_exclude that does not appear explicitly in the search + search.exclude\_tags that does not appear explicitly in the search terms. This option specifies whether to omit excluded messages in the search process. @@ -146,9 +146,9 @@ message having multiple filenames. :: % notmuch search date:today.. and tag:bad-news - thread:0000000000063c10 Today [1/1] Some Persun; To the bone (inbox unread) - thread:0000000000063c25 Today [1/1(2)] Ann Other; Bears (inbox unread) - thread:0000000000063c00 Today [1/1] A Thurd; Bites, stings, sad feelings (inbox unread) + thread:0000000000063c10 Today [1/1] Some Persun; To the bone (bad-news inbox unread) + thread:0000000000063c25 Today [1/1(2)] Ann Other; Bears (bad-news inbox unread) + thread:0000000000063c00 Today [1/1] A Thurd; Bites, stings, sad feelings (bad-news unread) EXIT STATUS ===========