X-Git-Url: https://git.cworth.org/git?a=blobdiff_plain;f=manpages%2Fnotmuch-search-1.mdwn;h=18b268e285000075eb26f27367ffe74524ac3a2f;hb=75474bbc91dc470f292067ad365d5288c09eb0f2;hp=4adb33bdf0d4e91cdff6fd9bdd0189c26f7c06ac;hpb=47c9a681445722a5b996786fb97df71747615bb7;p=notmuch-wiki diff --git a/manpages/notmuch-search-1.mdwn b/manpages/notmuch-search-1.mdwn index 4adb33b..18b268e 100644 --- a/manpages/notmuch-search-1.mdwn +++ b/manpages/notmuch-search-1.mdwn @@ -12,8 +12,8 @@
- 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,31 +46,31 @@ 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 - matching the search terms, either one per line (--forâ - mat=text), separated by null characters (--format=text0), - as a JSON array (--format=json), or an S-Expression list - (--format=sexp). + matching the search terms, either one per line (--for- + mat=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), sepaâ - rated by null characters (--format=text0), as a JSON - array (--format=json), or as an S-Expression list (--forâ - mat=sexp). + search terms, either one per line (--format=text), sepaâ + 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 - terms, either one per line (--format=text), separated by - null characters (--format=text0), as a JSON array (--forâ - mat=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 (--for- + mat=json), or as an S-Expression list (--format=sexp). Note that each message may have multiple filenames assoâ ciated with it. All of them are included in the output - (unless limited with the --duplicate=N option). This may + (unless 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 dupliâ cates in other directories that are included in the outâ @@ -78,18 +78,18 @@ search. 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â - mat=sexp). + search terms, either one per line (--format=text), sepaâ + 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. @@ -106,16 +106,16 @@ --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 - terms. This option specifies whether to omit excluded messages - in the search process. + search.exclude_tags that does not appear explicitly in the + search terms. This option specifies whether to omit excluded + messages in the search process. 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-2018, Carl Worth and many others + 2009-2021, Carl Worth and many others-0.27
+0.34