Re: [PATCH 9/9] add has: query prefix to search for specific properties

Subject: Re: [PATCH 9/9] add has: query prefix to search for specific properties

Date: Sat, 06 Aug 2016 23:18:53 +0900

To: notmuch@notmuchmail.org

Cc: Daniel Kahn Gillmor, Jani Nikula

From: David Bremner


David Bremner <david@tethera.net> writes:

>  
> +The **has:** prefix searches for messages with a particular
> +<key>=<value> 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

Thread: