doc: notmuch help search-terms, boolean operators

Subject: doc: notmuch help search-terms, boolean operators

Date: Wed, 27 Apr 2011 00:24:38 +0200

To: notmuch@notmuchmail.org

Cc:

From: Florian Friesdorf


`notmuch help search-terms` currently states: "In addition to
individual terms, multiple terms can be combined with Boolean operators
("and", "or", "not", etc.).".

I would like to replace the "etc" with a full list and document the
operator precedence.

In lib/notmuch.h for notmuch_query_create I found a pointer to xapian
docs [2], which states that AND takes precedence over OR, but nothing
for NOT and XOR.

Through playing with `notmuch tag` and `notmuch search
--output=messages` I found:

Complete list of boolean operators in order of precedence:
- NOT
- AND
- XOR
- OR

Is this correct? If yes, I would extend the manpage accordingly.

[2] http://xapian.org/docs/queryparser.html

-- 
Florian Friesdorf <flo@chaoflow.net>
  GPG FPR: 7A13 5EEE 1421 9FC2 108D  BAAF 38F8 99A3 0C45 F083
Jabber/XMPP: flo@chaoflow.net
IRC: chaoflow on freenode,ircnet,blafasel,OFTC
part-000.sig (application/pgp-signature)

Thread: