From 20ba0b7dfae2111f76d71c8d695265014c2ef7c5 Mon Sep 17 00:00:00 2001 From: David Bremner Date: Sat, 7 Apr 2018 19:10:51 -0300 Subject: [PATCH] doc: add a section on quoting to notmuch-search-terms(7) I think we've diverged enough from the Xapian query parser that we can't rely on that syntax description [1]. As far as I can tell, [1] also only discusses quotes in the context of phrases. [1]: https://xapian.org/docs/queryparser.html --- doc/man7/notmuch-search-terms.rst | 24 +++++++++++++++++++++++- 1 file changed, 23 insertions(+), 1 deletion(-) diff --git a/doc/man7/notmuch-search-terms.rst b/doc/man7/notmuch-search-terms.rst index b4d784a3..248444e3 100644 --- a/doc/man7/notmuch-search-terms.rst +++ b/doc/man7/notmuch-search-terms.rst @@ -42,7 +42,7 @@ of the prefixes with forms can be also used to restrict the results to those whose value matches a regular expression (see **regex(7)**) delimited with //, for example:: - notmuch search 'from:/bob@.*[.]example[.]com/' + notmuch search 'from:"/bob@.*[.]example[.]com/"' from: or from:// The **from:** prefix is used to match the name or address of @@ -273,6 +273,28 @@ Both of these will match a subject "Free Delicious Pizza" while will not. +Quoting +------- + +Double quotes are also used by the notmuch query parser to protect +boolean terms or regular expressions containing spaces or other +special characters, e.g. + +:: + + tag:"a tag" + +:: + + folder:"/^.*/(Junk|Spam)$/" + +As with phrases, you need to protect the double quotes from the shell +e.g. + +:: + + % notmuch search 'folder:"/^.*/(Junk|Spam)$/"' + DATE AND TIME SEARCH ==================== -- 2.43.0