X-Git-Url: https://git.cworth.org/git?a=blobdiff_plain;f=manpages%2Fnotmuch-search-1.mdwn;h=6ea3bab36c96cbbade398ff6627dba2e9126200e;hb=219490b75a85ca18d449168575a0c7538e71612e;hp=4adb33bdf0d4e91cdff6fd9bdd0189c26f7c06ac;hpb=47c9a681445722a5b996786fb97df71747615bb7;p=notmuch-wiki
diff --git a/manpages/notmuch-search-1.mdwn b/manpages/notmuch-search-1.mdwn
index 4adb33b..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,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)
+ 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-2022, Carl Worth and many others
-0.27
+0.35