Re: Native query language

Hi Tom:

In message <SJ0PR08MB794871C539F517A58C2B8212CA599@SJ0PR08MB7948.namprd08.prod.
outlook.com>,
Tom Ekberg writes:
> > Do you have a suggestion on where to put further documentation on
> >how full text search works in native mode? Which doc would you expect
> >to cover that?
>The file doc/overview.txt has a section titled
>"Browsing and Searching" at the end of the file.

IIRC the overview doc was part of the original proposal. It describes
a widget based filtering/searching method that AFAIK was never
implemented. So I think I will leave it as is.

>The "Roundup User Guide" has a section titled "Searching
>Page". Either of these would be a place to document full text
>searching using native mode.

In the section 'Under the covers' of user_guide.txt where @search_text
is defined I have added:

    Full text search using the xapian, whoosh and native indexers treats
    the search query as a series of space separated words. Any word less
    than 2 characters or more than 25 characters is discarded. Also a
    stoplist is used to remove common words like "with", "and"
    etc. Additional stoplist words can be added in the tracker's
    config.ini file. Once filtering of the word list is done, each indexed
    item (e.g. title, file or message content ...) is searched and if all
    the terms are found in the item the item is returned. Then the items
    are mapped to an issue and the list of matching issues is generated.

    Other searching backends such as native-fts can be used in which
    case the filtering above is not used. The search query can support
    structure such as quoted phrases, matching one term or another
    rather than both (or search), prefixes etc. In this case you
    should look at the documentation for the native-fts backend to
    find the supported format and features.

These paragraphs were added after the example url in the doc.

Questions, comments?

Have a great day.

--
				-- rouilj
John Rouillard
===========================================================================
My employers don't acknowledge my existence much less my opinions.