From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp2 ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms11 with LMTPS id Ksv5FAK11l6OJgAA0tVLHw (envelope-from ) for ; Tue, 02 Jun 2020 20:22:26 +0000 Received: from aspmx1.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp2 with LMTPS id YAZDEAK11l7MawAAB5/wlQ (envelope-from ) for ; Tue, 02 Jun 2020 20:22:26 +0000 Received: from arlo.cworth.org (arlo.cworth.org [50.126.95.6]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) server-signature RSA-PSS (4096 bits)) (No client certificate requested) by aspmx1.migadu.com (Postfix) with ESMTPS id 550C7940058 for ; Tue, 2 Jun 2020 20:22:23 +0000 (UTC) Received: from localhost (localhost [127.0.0.1]) by arlo.cworth.org (Postfix) with ESMTP id E37AD6DE02AC; Tue, 2 Jun 2020 13:22:19 -0700 (PDT) X-Virus-Scanned: Debian amavisd-new at cworth.org Received: from arlo.cworth.org ([127.0.0.1]) by localhost (arlo.cworth.org [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id x5gLDZ423v5d; Tue, 2 Jun 2020 13:22:19 -0700 (PDT) Received: from arlo.cworth.org (localhost [IPv6:::1]) by arlo.cworth.org (Postfix) with ESMTP id 826136DE0F4C; Tue, 2 Jun 2020 13:22:18 -0700 (PDT) Received: from localhost (localhost [127.0.0.1]) by arlo.cworth.org (Postfix) with ESMTP id 790476DE0F4C for ; Tue, 2 Jun 2020 13:22:17 -0700 (PDT) X-Virus-Scanned: Debian amavisd-new at cworth.org Received: from arlo.cworth.org ([127.0.0.1]) by localhost (arlo.cworth.org [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id BQm-G48so_2P for ; Tue, 2 Jun 2020 13:22:16 -0700 (PDT) Received: from lahtoruutu.iki.fi (lahtoruutu.iki.fi [185.185.170.37]) by arlo.cworth.org (Postfix) with ESMTPS id 00E546DE02AC for ; Tue, 2 Jun 2020 13:22:13 -0700 (PDT) Received: from guru.guru-group.fi (guru.guru-group.fi [46.183.73.34]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) (Authenticated sender: too) by lahtoruutu.iki.fi (Postfix) with ESMTPSA id 39B981B00348; Tue, 2 Jun 2020 23:22:10 +0300 (EEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=iki.fi; s=lahtoruutu; t=1591129330; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc; bh=+1ZNeE6S0Lljava/5Mxx4pA7yeZtI5F61lBa0A9KScI=; b=I3AQJ3tutGTAyJ9YiRTWQRcPR9rsWLVYA88qUkQVRlHBBVvkqwC0GIk9tp9NBy3FG4CDH3 3pAhqVNTU/okPa6dNJ+lLa2pGPXlVAumHeI2Q38ANsom8RNs0N9iIL8zLN38MJvCwE63ng Zbc4XjO2DOvQkkl9FToHr82UE1aHZe8jrxCuRHzFNqaY5YmjPr+SrdlUybX+0VyQmrsLtW a7fo6uQJTJr9EE1KmkqD5D7iy53cdAgEkzFIpAmi8JritQXJOUQ9Jlg+SgRpHqEGkx1GLO P1LUlUBVN2IXUy/ixEdThkZ/nc8VypJGCIOycmuI+0MKiAQ9TArwbxNjJN97sw== From: Tomi Ollila To: notmuch@notmuchmail.org Subject: [PATCH] doc: field processor support now always included, adjust manual pages Date: Tue, 2 Jun 2020 23:21:59 +0300 Message-Id: <20200602202159.28395-1-tomi.ollila@iki.fi> X-Mailer: git-send-email 2.13.3 ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=iki.fi; s=lahtoruutu; t=1591129330; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc; bh=+1ZNeE6S0Lljava/5Mxx4pA7yeZtI5F61lBa0A9KScI=; b=IvlC9xeI0SZIotXAm+YFvK3ubOUfp8gpGwikkfOUAOlWQ5aSHaRxSv6V+oKxrDqeWLka+5 bH3Cc69lIQnpu9jcBGDyM+TLaqCv3LkeD4xamTlgu7ppRJ1DAL/+KfaEqNihmYYK5fBFXD AOaLeQRG0waYeZv5GH1m7YsZfEyJnSJuchjzt+UVw3vb0T1ic5X7dv2Xq/A3InGbchGdSP R3j3prVpg+bxQZEJv1gb5Bj0/68Ji3lNzSXbif/bb4HkHvAaQlEI+H9/FHUtriZEr+V1+7 ua4X4m9Xef4807A+V7bmtKk7/mbWqf+RmQoHm3TYRXNvE3R+hJ+3Xdw3hUNjcA== ARC-Seal: i=1; s=lahtoruutu; d=iki.fi; t=1591129330; a=rsa-sha256; cv=none; b=ann1xVPAnqJgcpGJ6xqGMzvjk53xJ4F2b/Lx32kn/An+k7exIx3/7qyhEbL/loWf9Tcjwg tjNNxHHME03rMvKVK8qPfn4+wj/D0wHhti8dzCEIxcegtG9gMS9M9iZO9UyDgjAtuac9dA sFub/nEVD5h37FBx5THkiXBJxQaCFQHF2/kydCOcn938Bcdh/Zihqi2Qpbx4eVHDfleeaU 0Lg0DYTkDG/qICdvmB44DXDJXrC1zepdN1FzRB5GggUu/hGdi4KCApRtiAvYKL+3UQK657 58bi9JdTymQdDjkMXNw8cEkgp4od3okSELxhB6wnwXYqIq3uqKh1r2sXjzb7Xw== ARC-Authentication-Results: i=1; ORIGINATING; auth=pass smtp.auth=too smtp.mailfrom=tomi.ollila@iki.fi X-BeenThere: notmuch@notmuchmail.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: "Use and development of the notmuch mail system." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: tomi.ollila@iki.fi MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit Errors-To: notmuch-bounces@notmuchmail.org Sender: "notmuch" X-Scanner: scn0 Authentication-Results: aspmx1.migadu.com; dkim=fail (body hash did not verify) header.d=iki.fi header.s=lahtoruutu header.b=I3AQJ3tu; dmarc=none; spf=pass (aspmx1.migadu.com: domain of notmuch-bounces@notmuchmail.org designates 50.126.95.6 as permitted sender) smtp.mailfrom=notmuch-bounces@notmuchmail.org X-Spam-Score: 2.99 X-TUID: LSxrJ8FAzdRv The features that require field processor support, are now just documented w/o mentioning **Xapian Field Processors**' is needed for those. Replaced "compact" and "field_processor" with "retry_lock" in build_with config option, as it is currently the only one that is optionally excluded. The former 2 are now documented as features always included. Dropped one 'we' "passive" in notmuch-search-terms.rst. It was the only one, and inconsistent with rest of the documentation in that file. Dropped message about conditional open-ended ranges support, as those are now always supported. --- doc/man1/notmuch-config.rst | 5 +-- doc/man7/notmuch-search-terms.rst | 54 +++++++++---------------------- 2 files changed, 18 insertions(+), 41 deletions(-) diff --git a/doc/man1/notmuch-config.rst b/doc/man1/notmuch-config.rst index 323a8b65..769f336a 100644 --- a/doc/man1/notmuch-config.rst +++ b/doc/man1/notmuch-config.rst @@ -198,8 +198,9 @@ The available configuration items are described below. **built_with.** Compile time feature . Current possibilities include - "compact" (see **notmuch-compact(1)**) and "field_processor" (see - **notmuch-search-terms(7)**). + "retry_lock" (configure option, included by default). + (since notmuch 0.30, "compact" and "field_processor" are + always included.) **query.** **[STORED IN DATABASE]** Expansion for named query called . See diff --git a/doc/man7/notmuch-search-terms.rst b/doc/man7/notmuch-search-terms.rst index 1dd2dc58..28fca737 100644 --- a/doc/man7/notmuch-search-terms.rst +++ b/doc/man7/notmuch-search-terms.rst @@ -37,9 +37,8 @@ In addition to free text, the following prefixes can be used to force terms to match against specific portions of an email, (where indicate user-supplied values). -If notmuch is built with **Xapian Field Processors** (see below) some -of the prefixes with forms can be also used to restrict the -results to those whose value matches a regular expression (see +Some 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/"' @@ -87,8 +86,7 @@ thread: of output from **notmuch search** thread:{} - If notmuch is built with **Xapian Field Processors** (see below), - threads may be searched for indirectly by providing an arbitrary + Threads may be searched for indirectly by providing an arbitrary notmuch query in **{}**. For example, the following returns threads containing a message from mallory and one (not necessarily the same message) with Subject containing the word "crypto". @@ -158,9 +156,7 @@ lastmod:.. query: The **query:** prefix allows queries to refer to previously saved - queries added with **notmuch-config(1)**. Named queries are only - available if notmuch is built with **Xapian Field Processors** - (see below). + queries added with **notmuch-config(1)**. property:= The **property:** prefix searches for messages with a particular @@ -353,23 +349,21 @@ since 1970-01-01 00:00:00 UTC. For example: date:@..@ -date:..! can be used as a shorthand for date:... The -expansion takes place before interpretation, and thus, for example, -date:monday..! matches from the beginning of Monday until the end of -Monday. -With **Xapian Field Processor** support (see below), non-range -date queries such as date:yesterday will work, but otherwise -will give unexpected results; if in doubt use date:yesterday..! - -Currently, we do not support spaces in range expressions. You can +Currently, spaces in range expressions are not supported. You can replace the spaces with '\_', or (in most cases) '-', or (in some cases) leave the spaces out altogether. Examples in this man page use spaces for clarity. -Open-ended ranges are supported (since Xapian 1.2.1), i.e. it's possible -to specify date:.. or date:.. to not limit the start or -end time, respectively. Pre-1.2.1 Xapian does not report an error on -open ended ranges, but it does not work as expected either. +Open-ended ranges are supported. I.e. it's possible to specify +date:.. or date:.. to not limit the start or +end time, respectively. + +Single expression +----------------- + +date: works as a shorthand for date:... +For example, date:monday matches from the beginning of Monday until +the end of Monday. Relative date and time ---------------------- @@ -446,24 +440,6 @@ Time zones Some time zone codes, e.g. UTC, EET. -XAPIAN FIELD PROCESSORS -======================= - -Certain optional features of the notmuch query processor rely on the -presence of the Xapian field processor API. You can determine if your -notmuch was built against a sufficiently recent version of Xapian by running - -:: - - % notmuch config get built_with.field_processor - -Currently the following features require field processor support: - -- non-range date queries, e.g. "date:today" -- named queries e.g. "query:my_special_query" -- regular expression searches, e.g. "subject:/^\\[SPAM\\]/" -- thread subqueries, e.g. "thread:{from:bob}" - SEE ALSO ======== -- 2.25.1