From 78a100c4fe1c8b15d969fde0da4fada310044578 Mon Sep 17 00:00:00 2001 From: David Bremner Date: Sat, 6 Aug 2016 23:18:53 +0900 Subject: [PATCH] Re: [PATCH 9/9] add has: query prefix to search for specific properties --- d7/f0cb5e33dec8714702963f79b646855fd200c9 | 76 +++++++++++++++++++++++ 1 file changed, 76 insertions(+) create mode 100644 d7/f0cb5e33dec8714702963f79b646855fd200c9 diff --git a/d7/f0cb5e33dec8714702963f79b646855fd200c9 b/d7/f0cb5e33dec8714702963f79b646855fd200c9 new file mode 100644 index 000000000..1a5926ec0 --- /dev/null +++ b/d7/f0cb5e33dec8714702963f79b646855fd200c9 @@ -0,0 +1,76 @@ +Return-Path: +X-Original-To: notmuch@notmuchmail.org +Delivered-To: notmuch@notmuchmail.org +Received: from localhost (localhost [127.0.0.1]) + by arlo.cworth.org (Postfix) with ESMTP id 5B48F6DE012F + for ; Sat, 6 Aug 2016 07:19:06 -0700 (PDT) +X-Virus-Scanned: Debian amavisd-new at cworth.org +X-Spam-Flag: NO +X-Spam-Score: -0.008 +X-Spam-Level: +X-Spam-Status: No, score=-0.008 tagged_above=-999 required=5 tests=[AWL=0.003, + SPF_PASS=-0.001, T_RP_MATCHES_RCVD=-0.01] autolearn=disabled +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 6rXlws7u-ub2 for ; + Sat, 6 Aug 2016 07:18:58 -0700 (PDT) +Received: from fethera.tethera.net (fethera.tethera.net [198.245.60.197]) + by arlo.cworth.org (Postfix) with ESMTPS id 8C8CA6DE00DF + for ; Sat, 6 Aug 2016 07:18:58 -0700 (PDT) +Received: from remotemail by fethera.tethera.net with local (Exim 4.84_2) + (envelope-from ) + id 1bW2RU-0007Zp-2O; Sat, 06 Aug 2016 10:19:12 -0400 +Received: (nullmailer pid 23686 invoked by uid 1000); + Sat, 06 Aug 2016 14:18:53 -0000 +From: David Bremner +To: notmuch@notmuchmail.org +Cc: Daniel Kahn Gillmor , Jani Nikula +Subject: Re: [PATCH 9/9] add has: query prefix to search for specific + properties +In-Reply-To: <1470491559-3946-10-git-send-email-david@tethera.net> +References: <1470491559-3946-1-git-send-email-david@tethera.net> + <1470491559-3946-10-git-send-email-david@tethera.net> +User-Agent: Notmuch/0.22.1+61~g2ce0f13 (https://notmuchmail.org) Emacs/24.5.1 + (x86_64-pc-linux-gnu) +Date: Sat, 06 Aug 2016 23:18:53 +0900 +Message-ID: <87d1lm7zg2.fsf@maritornes.cs.unb.ca> +MIME-Version: 1.0 +Content-Type: text/plain +X-BeenThere: notmuch@notmuchmail.org +X-Mailman-Version: 2.1.20 +Precedence: list +List-Id: "Use and development of the notmuch mail system." + +List-Unsubscribe: , + +List-Archive: +List-Post: +List-Help: +List-Subscribe: , + +X-List-Received-Date: Sat, 06 Aug 2016 14:19:06 -0000 + +David Bremner writes: + +> +> +The **has:** prefix searches for messages with a particular +> += property pair. Properties are used internally by notmuch +> +(and extensions) to add metadata to messages. A given key can be +> +present on a given message with several different values. +> + + +I probably should have added to the commit message that this +documentation is intentionally minimal, because it's not intended for +people creating properties; that should go in API documentation, I think. + + +> + { "has", "XPROPERTY" }, +> /* +> * Without the ":", since this is a multi-letter prefix, Xapian +> * will add a colon itself if the first letter of the path + +I don't really understand the comment on the next line (since it seems +that no : is added to XPROPERTY by Xapian), but I guess we should +probably be consistent. Maybe Jani can explain the comment? + +d -- 2.26.2