From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp0 ([2001:41d0:2:bcc0::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms0.migadu.com with LMTPS id AIs+GKgOJWGg4QAAgWs5BA (envelope-from ) for ; Tue, 24 Aug 2021 17:22:16 +0200 Received: from aspmx1.migadu.com ([2001:41d0:2:bcc0::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp0 with LMTPS id qCD7E6gOJWFrHQAA1q6Kng (envelope-from ) for ; Tue, 24 Aug 2021 15:22:16 +0000 Received: from mail.notmuchmail.org (nmbug.tethera.net [IPv6:2607:5300:201:3100::1657]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits)) (No client certificate requested) by aspmx1.migadu.com (Postfix) with ESMTPS id 068918504 for ; Tue, 24 Aug 2021 17:22:16 +0200 (CEST) Received: from nmbug.tethera.net (localhost [127.0.0.1]) by mail.notmuchmail.org (Postfix) with ESMTP id 45FB320590; Tue, 24 Aug 2021 11:21:06 -0400 (EDT) Received: from fethera.tethera.net (fethera.tethera.net [198.245.60.197]) by mail.notmuchmail.org (Postfix) with ESMTP id 95FDC20584 for ; Tue, 24 Aug 2021 11:20:59 -0400 (EDT) Received: by fethera.tethera.net (Postfix, from userid 1001) id 8F7705FD5C; Tue, 24 Aug 2021 11:20:59 -0400 (EDT) Received: (nullmailer pid 2942901 invoked by uid 1000); Tue, 24 Aug 2021 15:17:52 -0000 From: David Bremner To: notmuch@notmuchmail.org Cc: David Bremner Subject: [PATCH 36/36] doc/sexp-queries: update synopsis and description Date: Tue, 24 Aug 2021 08:17:45 -0700 Message-Id: <20210824151745.2941868-37-david@tethera.net> X-Mailer: git-send-email 2.32.0 In-Reply-To: <20210824151745.2941868-1-david@tethera.net> References: <20210824151745.2941868-1-david@tethera.net> MIME-Version: 1.0 Message-ID-Hash: QW4MIPACEOYUDONJBAIGG66ZGNOWNUSV X-Message-ID-Hash: QW4MIPACEOYUDONJBAIGG66ZGNOWNUSV X-MailFrom: bremner@tethera.net X-Mailman-Rule-Misses: dmarc-mitigation; no-senders; approved; emergency; loop; banned-address; member-moderation; header-match-notmuch.notmuchmail.org-0; nonmember-moderation; administrivia; implicit-dest; max-recipients; max-size; news-moderation; no-subject; suspicious-header X-Mailman-Version: 3.2.1 Precedence: list List-Id: "Use and development of the notmuch mail system." List-Help: List-Post: List-Subscribe: List-Unsubscribe: Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Migadu-Flow: FLOW_IN ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1629818536; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references:list-id:list-help: list-unsubscribe:list-subscribe:list-post; bh=0JUFMj2EnOqJqvxAR0HktOnix35n336r/AtO2LnNMac=; b=bjI7g1U0H2F51xe4ehS0M/6V+aYeR4nT4SEA9OsmFYcP9oqNKfmAkQR4jGAFJ1zaydD+2S k1xEROZMkR6YD73pl2S2VaImLflICI1/C/vnRiEdJIOc1FMzhzpeLwVW0CqZnZERKHy7PD S+zEGx84AvhDFNK1NHlzWJMUNwZWeCK9JOzspSXHGSwdzQwNDf+tFKl3juKYEabwlL8Ooj eXYR3pVSX/zuYVTs0QIGnotFa0t2OyNkSmx/u/Osp8lFHxdpuC2i7ivkG964PGQC3QrLrO Fx4uYdNAXqcyvXx1PN+IfiK7XpxbXlKSTxvgtH6mPwxc92Ncb5+0gZ+9Aub+lQ== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1629818536; a=rsa-sha256; cv=none; b=Cvcz6pHet+jrIVZ8kEzU7YtvO4B+hSmOS9EaOuAV3wBbrcOFy6XL4ytZoUNEyP8tWgbUSZ sVH9FOuoc79cdPIuOS793HxLzirBTeUgjpvG44p8XWAXMuvS8DikBWSe3YYDqQiJ7fWvSc NjmWQR6nPyTDzemSZyQSGpSvtcAqPg5DWBAu8327HhuID7ZAvr2SPpvvKe4/hIaEtGC3r7 tgw3rn5aHsWk3G4tFnoY1xWKJp0Ha31yvgjhUnDmPtnItmpJOlqgrFXv3n0V/JvsFwZLMD 5gnWds088lW47jwr37PDUFea+eEgf6B6t7Usge5j6BoNXSVF+Rr+DmmdushDmw== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=none; dmarc=none; spf=pass (aspmx1.migadu.com: domain of notmuch-bounces@notmuchmail.org designates 2607:5300:201:3100::1657 as permitted sender) smtp.mailfrom=notmuch-bounces@notmuchmail.org X-Migadu-Spam-Score: -0.93 Authentication-Results: aspmx1.migadu.com; dkim=none; dmarc=none; spf=pass (aspmx1.migadu.com: domain of notmuch-bounces@notmuchmail.org designates 2607:5300:201:3100::1657 as permitted sender) smtp.mailfrom=notmuch-bounces@notmuchmail.org X-Migadu-Queue-Id: 068918504 X-Spam-Score: -0.93 X-Migadu-Scanner: scn0.migadu.com X-TUID: hBjX1cQAVbD5 I chose to go with a somewhat terse synopsis to try to keep the length of the page down. --- doc/man7/notmuch-sexp-queries.rst | 13 ++++++++++++- 1 file changed, 12 insertions(+), 1 deletion(-) diff --git a/doc/man7/notmuch-sexp-queries.rst b/doc/man7/notmuch-sexp-queries.rst index 81e3929b..019d15f0 100644 --- a/doc/man7/notmuch-sexp-queries.rst +++ b/doc/man7/notmuch-sexp-queries.rst @@ -7,11 +7,22 @@ notmuch-sexp-queries SYNOPSIS ======== -**notmuch** **search** ``--query=sexp`` '(and (to santa) (date december))' +**notmuch** *subcommand* ``--query=sexp`` [option ...] ``--`` '(and (to santa) (date december))' DESCRIPTION =========== +Notmuch supports an alternative query syntax based on `S-expressions +`_ . It can be selected +with the command line ``--query=sexp`` or with the appropriate option +to the library function :c:func:`notmuch_query_create_with_syntax`. +Support for this syntax is currently optional, you can test if your +build of notmuch supports it with + +:: + + $ notmuch config get built_with.sexpr_query + S-EXPRESSIONS ------------- -- 2.32.0