synonym expansion for boolean prefixes.

[Olly Betts]

On Sun, Jan 10, 2016 at 09:53:55AM -0400, David Bremner wrote:
> Olly Betts <olly at survex.com> writes:
> 
> > A better option for this is probably a FieldProcessor - you set one for
> > a prefix and the it gets passed the value and returns a Query object
> > for it.  E.g. in lua (where you can just pass an anon function for the
> > FieldProcessor - we ought to support C++11 lambdas for such things):
> 
> By the way, is there an online version of the FieldProcessor docs?

There's not a lavish amount of documentation for it currently, just the
doxygen comments in the header:

http://trac.xapian.org/browser/git/xapian-core/include/xapian/queryparser.h#L400

But we don't currently have the generated documentation for 1.3.x
online.  It would be good to (and particularly once 1.4.x is out to
have documentation for both the stable release series available),
but we could do with a sane structure for the parallel versions,
and make it clear when people are reading the docs for an unreleased
version.

I'm trying to ignore such issues for now, and focus on getting 1.4.0
out.  It would be good to have another documentation sprint, with a
focus on getting the "Getting Started" guide updated for 1.4.0.

> Also, can I expect the API to lose the "experimental" epithet before
> 1.4 is released?

You can just ignore that now (and I've just removed it from git master).

When FieldProcessor was added we weren't sure about how to select the
text it works on, but I think the current approach of consistent
splitting of text which FieldProcessor then gets to work on is sane.  If
we conclude later that this needs adjusting, we can go through the
normal process of changing a feature and deprecating the old version if
it can't just be done via a simple addition to the API.

Cheers,
    Olly