You are viewing a plain text version of this content. The canonical link for it is here.
Posted to java-commits@lucene.apache.org by mh...@apache.org on 2007/10/09 23:45:28 UTC
svn commit: r583307 [2/6] - in /lucene/java/trunk/contrib/xml-query-parser:
./ docs/ docs/img/
Added: lucene/java/trunk/contrib/xml-query-parser/docs/LuceneContribQuery.dtd.html
URL: http://svn.apache.org/viewvc/lucene/java/trunk/contrib/xml-query-parser/docs/LuceneContribQuery.dtd.html?rev=583307&view=auto
==============================================================================
--- lucene/java/trunk/contrib/xml-query-parser/docs/LuceneContribQuery.dtd.html (added)
+++ lucene/java/trunk/contrib/xml-query-parser/docs/LuceneContribQuery.dtd.html Tue Oct 9 14:45:27 2007
@@ -0,0 +1,1060 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html><head>
+<meta http-equiv='CONTENT-TYPE' content='text/html; charset=UTF-8' />
+<link rel='StyleSheet' href='DTDDocStyle.css' type='text/css' media='screen' />
+<title>Contrib Lucene</title>
+</head><body>
+<p class='DTDSource'><b><code>LuceneContribQuery.dtd</code></b>: <a href='LuceneContribQuery.dtd.html'>Elements</a> - <a href='LuceneContribQuery.dtd.entities.html'>Entities</a> - <a href='LuceneContribQuery.dtd.org.html'>Source</a> | <a href='intro.html'>Intro</a> - <a href='elementsIndex.html'>Index</a><br /><a href='index.html' target='_top'>FRAMES</a> / <a href='LuceneContribQuery.dtd.html' target='_top'>NO FRAMES</a></p><h1>Contrib Lucene</h1>
+<p>This DTD builds on the <a href="LuceneCoreQuery.dtd.html">core Lucene XML syntax</a> and adds support for features found in the "contrib" section of the Lucene project.</p><p>CorePlusExtensionsParser.java is the Java class that encapsulates this parser behaviour.</p><p>The features added are:
+<ul>
+<li><a href="#LikeThisQuery">LikeThisQuery</a></li>
+Support for querying using large amounts of example text indicative of the users' general area of interest
+<li><a href="#FuzzyLikeThisQuery">FuzzyLikeThisQuery</a></li>
+A style of fuzzy query which automatically looks for fuzzy variations on only the "interesting" terms
+<li><a href="#BooleanFilter">BooleanFilter</a></li>
+Is to Filters what core Lucene's BooleanQuery is to Queries - allows mixing of clauses using Boolean logic
+<li><a href="#TermsFilter">TermsFilter</a></li>
+Constructs a filter from an arbitrary set of terms (unlike <a href="#RangeFilter">RangeFilter</a> which requires a contiguous range of terms)
+<li><a href="#DuplicateFilter">DuplicateFilter</a></li>
+Removes duplicated documents from results where "duplicate" means documents share a value for a particular field (e.g. a primary key)
+<li><a href="#BoostingQuery">BoostingQuery</a></li>
+Influence score of a query's matches in a subtle way which can't be achieved using BooleanQuery
+</ul></p><br />
+<a name='BooleanQuery'></a>
+<br /><table class='elementTitle' summary="BooleanQuery"><tr><td class='leftElementTitle'>
+<BooleanQuery></td><td class='rightElementTitle'>
+Child of <a href='#Clause'>Clause</a>, <a href='#BoostQuery'>BoostQuery</a>, <a href='#Query'>Query</a>, <a href='#CachedFilter'>CachedFilter</a>
+</td></tr></table>
+<p>BooleanQuerys implement Boolean logic which controls how multiple Clauses should be interpreted.
+Some clauses may represent optional Query criteria while others represent mandatory criteria.</p><p><span class='inTextTitle'>Example:</span> <em>Find articles about banks, preferably talking about mergers but nothing to do with "sumitomo"</em>
+</p><pre>
+ <BooleanQuery fieldName="contents">
+ <Clause occurs="should">
+ <TermQuery>merger</TermQuery>
+ </Clause>
+ <Clause occurs="mustnot">
+ <TermQuery>sumitomo</TermQuery>
+ </Clause>
+ <Clause occurs="must">
+ <TermQuery>bank</TermQuery>
+ </Clause>
+ </BooleanQuery>
+
+ </pre><p></p><blockquote><table summary='element info'><tr>
+<td class='construct'><table summary="<BooleanQuery>'s children">
+<thead>
+<tr><th class='title' colspan='2'><BooleanQuery>'s children</th></tr>
+<tr><th colspan='2' height='1' class='ruler'></th></tr>
+<tr><th class='subtitle'>Name</th><th class='subtitle'>Cardinality</th></tr>
+<tr><th colspan='2' height='1' class='ruler'></th></tr>
+</thead>
+<tbody><tr><td><a href='#Clause'>Clause</a></td><td>At least one</td></tr>
+</tbody></table></td><td class='construct'><table summary="<BooleanQuery>'s attributes"><tr>
+<th class='title' colspan='3'><BooleanQuery>'s attributes</th>
+</tr>
+<tr><th colspan='3' height='1' class='ruler'></th></tr>
+<tr>
+<th class='subtitle'>Name</th><th class='subtitle'>Values</th><th class='subtitle'>Default</th></tr>
+<tr><th colspan='3' height='1' class='ruler'></th></tr>
+<tr><td><a href='#BooleanQuery_boost'>boost</a></td><td></td><td>1.0</td></tr><tr><td><a href='#BooleanQuery_disableCoord'>disableCoord</a></td><td>true, false</td><td>false</td></tr><tr><td><a href='#BooleanQuery_fieldName'>fieldName</a></td><td></td><td></td></tr><tr><td><a href='#BooleanQuery_minimumNumberShouldMatch'>minimumNumberShouldMatch</a></td><td></td><td>0</td></tr></table></td></tr></table></blockquote>
+<span class='inTextTitle'>Element's model:</span><p class='model'>(<a href='#Clause'>Clause</a>)+</p><a name='BooleanQuery_boost'></a>
+<br /><table class='attributeTitle' summary="boost"><tr><td class='leftAttributeTitle'>
+@boost</td><td class='rightAttributeTitle'>
+Attribute of <a href='#BooleanQuery'>BooleanQuery</a>
+</td></tr></table>
+<p>Optional boost for matches on this query. Values > 1</p><p><span class='inTextTitle'>Default value</span>: 1.0</p><a name='BooleanQuery_fieldName'></a>
+<br /><table class='attributeTitle' summary="fieldName"><tr><td class='leftAttributeTitle'>
+@fieldName</td><td class='rightAttributeTitle'>
+Attribute of <a href='#BooleanQuery'>BooleanQuery</a>
+</td></tr></table>
+<p>fieldName can optionally be defined here as a default attribute used by all child elements</p><a name='BooleanQuery_disableCoord'></a>
+<br /><table class='attributeTitle' summary="disableCoord"><tr><td class='leftAttributeTitle'>
+@disableCoord</td><td class='rightAttributeTitle'>
+Attribute of <a href='#BooleanQuery'>BooleanQuery</a>
+</td></tr></table>
+<p>The "Coordination factor" rewards documents that contain more of the optional clauses in this list. This flag can be used to turn off this factor.</p><p><span class='inTextTitle'>Possible values</span>: true, false - <span class='inTextTitle'>Default value</span>: false</p><a name='BooleanQuery_minimumNumberShouldMatch'></a>
+<br /><table class='attributeTitle' summary="minimumNumberShouldMatch"><tr><td class='leftAttributeTitle'>
+@minimumNumberShouldMatch</td><td class='rightAttributeTitle'>
+Attribute of <a href='#BooleanQuery'>BooleanQuery</a>
+</td></tr></table>
+<p>The minimum number of optional clauses that should be present in any one document before it is considered to be a match.</p><p><span class='inTextTitle'>Default value</span>: 0</p><a name='Clause'></a>
+<br /><table class='elementTitle' summary="Clause"><tr><td class='leftElementTitle'>
+<Clause></td><td class='rightElementTitle'>
+Child of <a href='#BooleanFilter'>BooleanFilter</a>, <a href='#BooleanQuery'>BooleanQuery</a>
+</td></tr></table>
+<p>NOTE: "Clause" tag has 2 modes of use - inside <BooleanQuery> in which case only "query" types can be
+child elements - while in a <BooleanFilter> clause only "filter" types can be contained.</p><blockquote><table summary='element info'><tr>
+<td class='construct'><table summary="<Clause>'s children">
+<thead>
+<tr><th class='title' colspan='2'><Clause>'s children</th></tr>
+<tr><th colspan='2' height='1' class='ruler'></th></tr>
+<tr><th class='subtitle'>Name</th><th class='subtitle'>Cardinality</th></tr>
+<tr><th colspan='2' height='1' class='ruler'></th></tr>
+</thead>
+<tbody><tr><td><a href='#BooleanFilter'>BooleanFilter</a></td><td>One or none</td></tr>
+<tr><td><a href='#BooleanQuery'>BooleanQuery</a></td><td>One or none</td></tr>
+<tr><td><a href='#BoostingQuery'>BoostingQuery</a></td><td>One or none</td></tr>
+<tr><td><a href='#CachedFilter'>CachedFilter</a></td><td>One or none</td></tr>
+<tr><td><a href='#ConstantScoreQuery'>ConstantScoreQuery</a></td><td>One or none</td></tr>
+<tr><td><a href='#DuplicateFilter'>DuplicateFilter</a></td><td>One or none</td></tr>
+<tr><td><a href='#FilteredQuery'>FilteredQuery</a></td><td>One or none</td></tr>
+<tr><td><a href='#FuzzyLikeThisQuery'>FuzzyLikeThisQuery</a></td><td>One or none</td></tr>
+<tr><td><a href='#LikeThisQuery'>LikeThisQuery</a></td><td>One or none</td></tr>
+<tr><td><a href='#MatchAllDocsQuery'>MatchAllDocsQuery</a></td><td>One or none</td></tr>
+<tr><td><a href='#RangeFilter'>RangeFilter</a></td><td>One or none</td></tr>
+<tr><td><a href='#SpanFirst'>SpanFirst</a></td><td>One or none</td></tr>
+<tr><td><a href='#SpanNear'>SpanNear</a></td><td>One or none</td></tr>
+<tr><td><a href='#SpanNot'>SpanNot</a></td><td>One or none</td></tr>
+<tr><td><a href='#SpanOr'>SpanOr</a></td><td>One or none</td></tr>
+<tr><td><a href='#SpanOrTerms'>SpanOrTerms</a></td><td>One or none</td></tr>
+<tr><td><a href='#SpanTerm'>SpanTerm</a></td><td>One or none</td></tr>
+<tr><td><a href='#TermQuery'>TermQuery</a></td><td>One or none</td></tr>
+<tr><td><a href='#TermsFilter'>TermsFilter</a></td><td>One or none</td></tr>
+<tr><td><a href='#TermsQuery'>TermsQuery</a></td><td>One or none</td></tr>
+<tr><td><a href='#UserQuery'>UserQuery</a></td><td>One or none</td></tr>
+</tbody></table></td><td class='construct'><table summary="<Clause>'s attributes"><tr>
+<th class='title' colspan='3'><Clause>'s attributes</th>
+</tr>
+<tr><th colspan='3' height='1' class='ruler'></th></tr>
+<tr>
+<th class='subtitle'>Name</th><th class='subtitle'>Values</th><th class='subtitle'>Default</th></tr>
+<tr><th colspan='3' height='1' class='ruler'></th></tr>
+<tr><td><a href='#Clause_occurs'>occurs</a></td><td>should, must, mustnot</td><td>should</td></tr></table></td></tr></table></blockquote>
+<span class='inTextTitle'>Element's model:</span><p class='model'>(<a href='#BooleanQuery'>BooleanQuery</a> | <a href='#UserQuery'>UserQuery</a> | <a href='#FilteredQuery'>FilteredQuery</a> | <a href='#TermQuery'>TermQuery</a> | <a href='#TermsQuery'>TermsQuery</a> | <a href='#MatchAllDocsQuery'>MatchAllDocsQuery</a> | <a href='#ConstantScoreQuery'>ConstantScoreQuery</a> | <a href='#SpanOr'>SpanOr</a> | <a href='#SpanNear'>SpanNear</a> | <a href='#SpanOrTerms'>SpanOrTerms</a> | <a href='#SpanFirst'>SpanFirst</a> | <a href='#SpanNot'>SpanNot</a> | <a href='#SpanTerm'>SpanTerm</a> | <a href='#LikeThisQuery'>LikeThisQuery</a> | <a href='#BoostingQuery'>BoostingQuery</a> | <a href='#FuzzyLikeThisQuery'>FuzzyLikeThisQuery</a> | <a href='#RangeFilter'>RangeFilter</a> | <a href='#CachedFilter'>CachedFilter</a> | <a href='#TermsFilter'>TermsFilter</a> | <a href='#BooleanFilter'>BooleanFilter</a> | <a href='#DuplicateFilter'>DuplicateFilter</a>)</p><a name='Clause_occurs'></a>
+<br /><table class='attributeTitle' summary="occurs"><tr><td class='leftAttributeTitle'>
+@occurs</td><td class='rightAttributeTitle'>
+Attribute of <a href='#Clause'>Clause</a>
+</td></tr></table>
+<p>Controls if the clause is optional (should), mandatory (must) or unacceptable (mustNot)</p><p><span class='inTextTitle'>Possible values</span>: should, must, mustnot - <span class='inTextTitle'>Default value</span>: should</p><a name='CachedFilter'></a>
+<br /><table class='elementTitle' summary="CachedFilter"><tr><td class='leftElementTitle'>
+<CachedFilter></td><td class='rightElementTitle'>
+Child of <a href='#Filter'>Filter</a>, <a href='#ConstantScoreQuery'>ConstantScoreQuery</a>, <a href='#Clause'>Clause</a>
+</td></tr></table>
+<p>Caches any nested query or filter in an LRU (Least recently used) Cache. Cached queries, like filters, are turned into
+Bitsets at a cost of 1 bit per document in the index. The memory cost of a cached query/filter is therefore numberOfDocsinIndex/8 bytes.
+Queries that are cached as filters obviously retain none of the scoring information associated with results - they retain just
+a Boolean yes/no record of which documents matched.</p><p><span class='inTextTitle'>Example:</span> <em>Search for documents about banks from the last 10 years - caching the commonly-used "last 10 year" filter as a BitSet in
+RAM to eliminate the cost of building this filter from disk for every query</em>
+</p><pre>
+ <FilteredQuery>
+ <Query>
+ <UserQuery>bank</UserQuery>
+ </Query>
+ <Filter>
+ <CachedFilter>
+ <RangeFilter fieldName="date" lowerTerm="19970101" upperTerm="20070101"/>
+ </CachedFilter>
+ </Filter>
+ </FilteredQuery>
+ </pre><p></p><blockquote><table summary='element info'><tr>
+<td class='construct'><table summary="<CachedFilter>'s children">
+<thead>
+<tr><th class='title' colspan='2'><CachedFilter>'s children</th></tr>
+<tr><th colspan='2' height='1' class='ruler'></th></tr>
+<tr><th class='subtitle'>Name</th><th class='subtitle'>Cardinality</th></tr>
+<tr><th colspan='2' height='1' class='ruler'></th></tr>
+</thead>
+<tbody><tr><td><a href='#BooleanFilter'>BooleanFilter</a></td><td>One or none</td></tr>
+<tr><td><a href='#BooleanQuery'>BooleanQuery</a></td><td>One or none</td></tr>
+<tr><td><a href='#BoostingQuery'>BoostingQuery</a></td><td>One or none</td></tr>
+<tr><td><a href='#CachedFilter'>CachedFilter</a></td><td>One or none</td></tr>
+<tr><td><a href='#ConstantScoreQuery'>ConstantScoreQuery</a></td><td>One or none</td></tr>
+<tr><td><a href='#DuplicateFilter'>DuplicateFilter</a></td><td>One or none</td></tr>
+<tr><td><a href='#FilteredQuery'>FilteredQuery</a></td><td>One or none</td></tr>
+<tr><td><a href='#FuzzyLikeThisQuery'>FuzzyLikeThisQuery</a></td><td>One or none</td></tr>
+<tr><td><a href='#LikeThisQuery'>LikeThisQuery</a></td><td>One or none</td></tr>
+<tr><td><a href='#MatchAllDocsQuery'>MatchAllDocsQuery</a></td><td>One or none</td></tr>
+<tr><td><a href='#RangeFilter'>RangeFilter</a></td><td>One or none</td></tr>
+<tr><td><a href='#SpanFirst'>SpanFirst</a></td><td>One or none</td></tr>
+<tr><td><a href='#SpanNear'>SpanNear</a></td><td>One or none</td></tr>
+<tr><td><a href='#SpanNot'>SpanNot</a></td><td>One or none</td></tr>
+<tr><td><a href='#SpanOr'>SpanOr</a></td><td>One or none</td></tr>
+<tr><td><a href='#SpanOrTerms'>SpanOrTerms</a></td><td>One or none</td></tr>
+<tr><td><a href='#SpanTerm'>SpanTerm</a></td><td>One or none</td></tr>
+<tr><td><a href='#TermQuery'>TermQuery</a></td><td>One or none</td></tr>
+<tr><td><a href='#TermsFilter'>TermsFilter</a></td><td>One or none</td></tr>
+<tr><td><a href='#TermsQuery'>TermsQuery</a></td><td>One or none</td></tr>
+<tr><td><a href='#UserQuery'>UserQuery</a></td><td>One or none</td></tr>
+</tbody></table></td></tr></table></blockquote>
+<span class='inTextTitle'>Element's model:</span><p class='model'>(<a href='#BooleanQuery'>BooleanQuery</a> | <a href='#UserQuery'>UserQuery</a> | <a href='#FilteredQuery'>FilteredQuery</a> | <a href='#TermQuery'>TermQuery</a> | <a href='#TermsQuery'>TermsQuery</a> | <a href='#MatchAllDocsQuery'>MatchAllDocsQuery</a> | <a href='#ConstantScoreQuery'>ConstantScoreQuery</a> | <a href='#SpanOr'>SpanOr</a> | <a href='#SpanNear'>SpanNear</a> | <a href='#SpanOrTerms'>SpanOrTerms</a> | <a href='#SpanFirst'>SpanFirst</a> | <a href='#SpanNot'>SpanNot</a> | <a href='#SpanTerm'>SpanTerm</a> | <a href='#LikeThisQuery'>LikeThisQuery</a> | <a href='#BoostingQuery'>BoostingQuery</a> | <a href='#FuzzyLikeThisQuery'>FuzzyLikeThisQuery</a> | <a href='#RangeFilter'>RangeFilter</a> | <a href='#CachedFilter'>CachedFilter</a> | <a href='#TermsFilter'>TermsFilter</a> | <a href='#BooleanFilter'>BooleanFilter</a> | <a href='#DuplicateFilter'>DuplicateFilter</a>)</p><a name='UserQuery'></a>
+<br /><table class='elementTitle' summary="UserQuery"><tr><td class='leftElementTitle'>
+<UserQuery></td><td class='rightElementTitle'>
+Child of <a href='#Clause'>Clause</a>, <a href='#BoostQuery'>BoostQuery</a>, <a href='#Query'>Query</a>, <a href='#CachedFilter'>CachedFilter</a>
+</td></tr></table>
+<p>Passes content directly through to the standard LuceneQuery parser see "Lucene Query Syntax"</p><p><span class='inTextTitle'>Example:</span> <em>Search for documents about John Smith or John Doe using standard LuceneQuerySyntax</em>
+</p><pre>
+ <UserQuery>"John Smith" OR "John Doe"</UserQuery>
+ </pre><p></p><blockquote><table summary='element info'><tr>
+<td class='construct'><table summary="<UserQuery>'s attributes"><tr>
+<th class='title' colspan='3'><UserQuery>'s attributes</th>
+</tr>
+<tr><th colspan='3' height='1' class='ruler'></th></tr>
+<tr>
+<th class='subtitle'>Name</th><th class='subtitle'>Values</th><th class='subtitle'>Default</th></tr>
+<tr><th colspan='3' height='1' class='ruler'></th></tr>
+<tr><td><a href='#UserQuery_boost'>boost</a></td><td></td><td>1.0</td></tr></table></td></tr></table></blockquote>
+<a name='UserQuery_boost'></a>
+<br /><table class='attributeTitle' summary="boost"><tr><td class='leftAttributeTitle'>
+@boost</td><td class='rightAttributeTitle'>
+Attribute of <a href='#UserQuery'>UserQuery</a>
+</td></tr></table>
+<p>Optional boost for matches on this query. Values > 1</p><p><span class='inTextTitle'>Default value</span>: 1.0</p><a name='MatchAllDocsQuery'></a>
+<br /><table class='elementTitle' summary="MatchAllDocsQuery"><tr><td class='leftElementTitle'>
+<MatchAllDocsQuery/></td><td class='rightElementTitle'>
+Child of <a href='#Clause'>Clause</a>, <a href='#BoostQuery'>BoostQuery</a>, <a href='#Query'>Query</a>, <a href='#CachedFilter'>CachedFilter</a>
+</td></tr></table>
+<p>A query which is used to match all documents. This has a couple of uses:
+<ol>
+<li> as a Clause in a BooleanQuery who's only other clause
+is a "mustNot" match (Lucene requires at least one positive clause) and..</li>
+<li> in a FilteredQuery where a Filter tag is effectively being
+used to select content rather than it's usual role of filtering the results of a query.</li>
+</ol></p><p><span class='inTextTitle'>Example:</span> <em>Effectively use a Filter as a query </em>
+</p><pre>
+ <FilteredQuery>
+ <Query>
+ <MatchAllDocsQuery/>
+ </Query>
+ <Filter>
+ <RangeFilter fieldName="date" lowerTerm="19870409" upperTerm="19870412"/>
+ </Filter>
+ </FilteredQuery>
+ </pre><p></p><p class='emptyTagNote'>This element is always empty.</p><a name='TermQuery'></a>
+<br /><table class='elementTitle' summary="TermQuery"><tr><td class='leftElementTitle'>
+<TermQuery></td><td class='rightElementTitle'>
+Child of <a href='#Clause'>Clause</a>, <a href='#BoostQuery'>BoostQuery</a>, <a href='#Query'>Query</a>, <a href='#CachedFilter'>CachedFilter</a>
+</td></tr></table>
+<p>a single term query - no analysis is done of the child text</p><p><span class='inTextTitle'>Example:</span> <em>Match on a primary key</em>
+</p><pre>
+ <TermQuery fieldName="primaryKey">13424</TermQuery>
+ </pre><p></p><blockquote><table summary='element info'><tr>
+<td class='construct'><table summary="<TermQuery>'s attributes"><tr>
+<th class='title' colspan='3'><TermQuery>'s attributes</th>
+</tr>
+<tr><th colspan='3' height='1' class='ruler'></th></tr>
+<tr>
+<th class='subtitle'>Name</th><th class='subtitle'>Values</th><th class='subtitle'>Default</th></tr>
+<tr><th colspan='3' height='1' class='ruler'></th></tr>
+<tr><td><a href='#TermQuery_boost'>boost</a></td><td></td><td>1.0</td></tr><tr><td><a href='#TermQuery_fieldName'>fieldName</a></td><td></td><td></td></tr></table></td></tr></table></blockquote>
+<a name='TermQuery_boost'></a>
+<br /><table class='attributeTitle' summary="boost"><tr><td class='leftAttributeTitle'>
+@boost</td><td class='rightAttributeTitle'>
+Attribute of <a href='#TermQuery'>TermQuery</a>
+</td></tr></table>
+<p>Optional boost for matches on this query. Values > 1</p><p><span class='inTextTitle'>Default value</span>: 1.0</p><a name='TermQuery_fieldName'></a>
+<br /><table class='attributeTitle' summary="fieldName"><tr><td class='leftAttributeTitle'>
+@fieldName</td><td class='rightAttributeTitle'>
+Attribute of <a href='#TermQuery'>TermQuery</a>
+</td></tr></table>
+<p>fieldName must be defined here or is taken from the most immediate parent XML element that defines a "fieldName" attribute</p><a name='TermsQuery'></a>
+<br /><table class='elementTitle' summary="TermsQuery"><tr><td class='leftElementTitle'>
+<TermsQuery></td><td class='rightElementTitle'>
+Child of <a href='#Clause'>Clause</a>, <a href='#BoostQuery'>BoostQuery</a>, <a href='#Query'>Query</a>, <a href='#CachedFilter'>CachedFilter</a>
+</td></tr></table>
+<p>The equivalent of a BooleanQuery with multiple optional TermQuery clauses.
+Child text is analyzed using a field-specific choice of Analyzer to produce a set of terms that are ORed together in Boolean logic.
+Unlike UserQuery element, this does not parse any special characters to control fuzzy/phrase/boolean logic and as such is incapable
+of producing a Query parse error given any user input</p><p><span class='inTextTitle'>Example:</span> <em>Match on text from a database description (which may contain characters that
+are illegal characters in the standard Lucene Query syntax used in the UserQuery tag</em>
+</p><pre>
+ <TermsQuery fieldName="description">Smith & Sons (Ltd) : incorporated 1982</TermsQuery>
+ </pre><p></p><blockquote><table summary='element info'><tr>
+<td class='construct'><table summary="<TermsQuery>'s attributes"><tr>
+<th class='title' colspan='3'><TermsQuery>'s attributes</th>
+</tr>
+<tr><th colspan='3' height='1' class='ruler'></th></tr>
+<tr>
+<th class='subtitle'>Name</th><th class='subtitle'>Values</th><th class='subtitle'>Default</th></tr>
+<tr><th colspan='3' height='1' class='ruler'></th></tr>
+<tr><td><a href='#TermsQuery_boost'>boost</a></td><td></td><td>1.0</td></tr><tr><td><a href='#TermsQuery_disableCoord'>disableCoord</a></td><td>true, false</td><td>false</td></tr><tr><td><a href='#TermsQuery_fieldName'>fieldName</a></td><td></td><td></td></tr><tr><td><a href='#TermsQuery_minimumNumberShouldMatch'>minimumNumberShouldMatch</a></td><td></td><td>0</td></tr></table></td></tr></table></blockquote>
+<a name='TermsQuery_boost'></a>
+<br /><table class='attributeTitle' summary="boost"><tr><td class='leftAttributeTitle'>
+@boost</td><td class='rightAttributeTitle'>
+Attribute of <a href='#TermsQuery'>TermsQuery</a>
+</td></tr></table>
+<p>Optional boost for matches on this query. Values > 1</p><p><span class='inTextTitle'>Default value</span>: 1.0</p><a name='TermsQuery_fieldName'></a>
+<br /><table class='attributeTitle' summary="fieldName"><tr><td class='leftAttributeTitle'>
+@fieldName</td><td class='rightAttributeTitle'>
+Attribute of <a href='#TermsQuery'>TermsQuery</a>
+</td></tr></table>
+<p>fieldName must be defined here or is taken from the most immediate parent XML element that defines a "fieldName" attribute</p><a name='TermsQuery_disableCoord'></a>
+<br /><table class='attributeTitle' summary="disableCoord"><tr><td class='leftAttributeTitle'>
+@disableCoord</td><td class='rightAttributeTitle'>
+Attribute of <a href='#TermsQuery'>TermsQuery</a>
+</td></tr></table>
+<p>The "Coordination factor" rewards documents that contain more of the terms in this list. This flag can be used to turn off this factor.</p><p><span class='inTextTitle'>Possible values</span>: true, false - <span class='inTextTitle'>Default value</span>: false</p><a name='TermsQuery_minimumNumberShouldMatch'></a>
+<br /><table class='attributeTitle' summary="minimumNumberShouldMatch"><tr><td class='leftAttributeTitle'>
+@minimumNumberShouldMatch</td><td class='rightAttributeTitle'>
+Attribute of <a href='#TermsQuery'>TermsQuery</a>
+</td></tr></table>
+<p>The minimum number of terms that should be present in any one document before it is considered to be a match.</p><p><span class='inTextTitle'>Default value</span>: 0</p><a name='FilteredQuery'></a>
+<br /><table class='elementTitle' summary="FilteredQuery"><tr><td class='leftElementTitle'>
+<FilteredQuery></td><td class='rightElementTitle'>
+Child of <a href='#Clause'>Clause</a>, <a href='#BoostQuery'>BoostQuery</a>, <a href='#Query'>Query</a>, <a href='#CachedFilter'>CachedFilter</a>
+</td></tr></table>
+<p>Runs a Query and filters results to only those query matches that also match the Filter element.</p><p><span class='inTextTitle'>Example:</span> <em>Find all documents about Lucene that have a status of "published"</em>
+</p><pre>
+ <FilteredQuery>
+ <Query>
+ <UserQuery>Lucene</UserQuery>
+ </Query>
+ <Filter>
+ <TermsFilter fieldName="status">published</TermsFilter>
+ </Filter>
+ </FilteredQuery>
+ </pre><p></p><blockquote><table summary='element info'><tr>
+<td class='construct'><table summary="<FilteredQuery>'s children">
+<thead>
+<tr><th class='title' colspan='2'><FilteredQuery>'s children</th></tr>
+<tr><th colspan='2' height='1' class='ruler'></th></tr>
+<tr><th class='subtitle'>Name</th><th class='subtitle'>Cardinality</th></tr>
+<tr><th colspan='2' height='1' class='ruler'></th></tr>
+</thead>
+<tbody><tr><td><a href='#Filter'>Filter</a></td><td>Only one</td></tr>
+<tr><td><a href='#Query'>Query</a></td><td>Only one</td></tr>
+</tbody></table></td><td class='construct'><table summary="<FilteredQuery>'s attributes"><tr>
+<th class='title' colspan='3'><FilteredQuery>'s attributes</th>
+</tr>
+<tr><th colspan='3' height='1' class='ruler'></th></tr>
+<tr>
+<th class='subtitle'>Name</th><th class='subtitle'>Values</th><th class='subtitle'>Default</th></tr>
+<tr><th colspan='3' height='1' class='ruler'></th></tr>
+<tr><td><a href='#FilteredQuery_boost'>boost</a></td><td></td><td>1.0</td></tr></table></td></tr></table></blockquote>
+<span class='inTextTitle'>Element's model:</span><p class='model'>(<a href='#Query'>Query</a>, <a href='#Filter'>Filter</a>)</p><a name='FilteredQuery_boost'></a>
+<br /><table class='attributeTitle' summary="boost"><tr><td class='leftAttributeTitle'>
+@boost</td><td class='rightAttributeTitle'>
+Attribute of <a href='#FilteredQuery'>FilteredQuery</a>
+</td></tr></table>
+<p>Optional boost for matches on this query. Values > 1</p><p><span class='inTextTitle'>Default value</span>: 1.0</p><a name='Query'></a>
+<br /><table class='elementTitle' summary="Query"><tr><td class='leftElementTitle'>
+<Query></td><td class='rightElementTitle'>
+Child of <a href='#FilteredQuery'>FilteredQuery</a>, <a href='#BoostingQuery'>BoostingQuery</a>
+</td></tr></table>
+<p>Used to identify a nested Query element inside another container element. NOT a top-level query tag</p><blockquote><table summary='element info'><tr>
+<td class='construct'><table summary="<Query>'s children">
+<thead>
+<tr><th class='title' colspan='2'><Query>'s children</th></tr>
+<tr><th colspan='2' height='1' class='ruler'></th></tr>
+<tr><th class='subtitle'>Name</th><th class='subtitle'>Cardinality</th></tr>
+<tr><th colspan='2' height='1' class='ruler'></th></tr>
+</thead>
+<tbody><tr><td><a href='#BooleanQuery'>BooleanQuery</a></td><td>One or none</td></tr>
+<tr><td><a href='#BoostingQuery'>BoostingQuery</a></td><td>One or none</td></tr>
+<tr><td><a href='#ConstantScoreQuery'>ConstantScoreQuery</a></td><td>One or none</td></tr>
+<tr><td><a href='#FilteredQuery'>FilteredQuery</a></td><td>One or none</td></tr>
+<tr><td><a href='#FuzzyLikeThisQuery'>FuzzyLikeThisQuery</a></td><td>One or none</td></tr>
+<tr><td><a href='#LikeThisQuery'>LikeThisQuery</a></td><td>One or none</td></tr>
+<tr><td><a href='#MatchAllDocsQuery'>MatchAllDocsQuery</a></td><td>One or none</td></tr>
+<tr><td><a href='#SpanFirst'>SpanFirst</a></td><td>One or none</td></tr>
+<tr><td><a href='#SpanNear'>SpanNear</a></td><td>One or none</td></tr>
+<tr><td><a href='#SpanNot'>SpanNot</a></td><td>One or none</td></tr>
+<tr><td><a href='#SpanOr'>SpanOr</a></td><td>One or none</td></tr>
+<tr><td><a href='#SpanOrTerms'>SpanOrTerms</a></td><td>One or none</td></tr>
+<tr><td><a href='#SpanTerm'>SpanTerm</a></td><td>One or none</td></tr>
+<tr><td><a href='#TermQuery'>TermQuery</a></td><td>One or none</td></tr>
+<tr><td><a href='#TermsQuery'>TermsQuery</a></td><td>One or none</td></tr>
+<tr><td><a href='#UserQuery'>UserQuery</a></td><td>One or none</td></tr>
+</tbody></table></td></tr></table></blockquote>
+<span class='inTextTitle'>Element's model:</span><p class='model'>(<a href='#BooleanQuery'>BooleanQuery</a> | <a href='#UserQuery'>UserQuery</a> | <a href='#FilteredQuery'>FilteredQuery</a> | <a href='#TermQuery'>TermQuery</a> | <a href='#TermsQuery'>TermsQuery</a> | <a href='#MatchAllDocsQuery'>MatchAllDocsQuery</a> | <a href='#ConstantScoreQuery'>ConstantScoreQuery</a> | <a href='#SpanOr'>SpanOr</a> | <a href='#SpanNear'>SpanNear</a> | <a href='#SpanOrTerms'>SpanOrTerms</a> | <a href='#SpanFirst'>SpanFirst</a> | <a href='#SpanNot'>SpanNot</a> | <a href='#SpanTerm'>SpanTerm</a> | <a href='#LikeThisQuery'>LikeThisQuery</a> | <a href='#BoostingQuery'>BoostingQuery</a> | <a href='#FuzzyLikeThisQuery'>FuzzyLikeThisQuery</a>)</p><a name='Filter'></a>
+<br /><table class='elementTitle' summary="Filter"><tr><td class='leftElementTitle'>
+<Filter></td><td class='rightElementTitle'>
+Child of <a href='#FilteredQuery'>FilteredQuery</a>
+</td></tr></table>
+<p>The choice of Filter that MUST also be matched</p><blockquote><table summary='element info'><tr>
+<td class='construct'><table summary="<Filter>'s children">
+<thead>
+<tr><th class='title' colspan='2'><Filter>'s children</th></tr>
+<tr><th colspan='2' height='1' class='ruler'></th></tr>
+<tr><th class='subtitle'>Name</th><th class='subtitle'>Cardinality</th></tr>
+<tr><th colspan='2' height='1' class='ruler'></th></tr>
+</thead>
+<tbody><tr><td><a href='#BooleanFilter'>BooleanFilter</a></td><td>One or none</td></tr>
+<tr><td><a href='#CachedFilter'>CachedFilter</a></td><td>One or none</td></tr>
+<tr><td><a href='#DuplicateFilter'>DuplicateFilter</a></td><td>One or none</td></tr>
+<tr><td><a href='#RangeFilter'>RangeFilter</a></td><td>One or none</td></tr>
+<tr><td><a href='#TermsFilter'>TermsFilter</a></td><td>One or none</td></tr>
+</tbody></table></td></tr></table></blockquote>
+<span class='inTextTitle'>Element's model:</span><p class='model'>(<a href='#RangeFilter'>RangeFilter</a> | <a href='#CachedFilter'>CachedFilter</a> | <a href='#TermsFilter'>TermsFilter</a> | <a href='#BooleanFilter'>BooleanFilter</a> | <a href='#DuplicateFilter'>DuplicateFilter</a>)</p><a name='RangeFilter'></a>
+<br /><table class='elementTitle' summary="RangeFilter"><tr><td class='leftElementTitle'>
+<RangeFilter/></td><td class='rightElementTitle'>
+Child of <a href='#Filter'>Filter</a>, <a href='#ConstantScoreQuery'>ConstantScoreQuery</a>, <a href='#Clause'>Clause</a>, <a href='#CachedFilter'>CachedFilter</a>
+</td></tr></table>
+<p>Filter used to limit query results to documents matching a range of field values</p><p><span class='inTextTitle'>Example:</span> <em>Search for documents about banks from the last 10 years</em>
+</p><pre>
+ <FilteredQuery>
+ <Query>
+ <UserQuery>bank</UserQuery>
+ </Query>
+ <Filter>
+ <RangeFilter fieldName="date" lowerTerm="19970101" upperTerm="20070101"/>
+ </Filter>
+ </FilteredQuery>
+ </pre><p></p><blockquote>
+<table summary="<RangeFilter>'s attributes"><tr>
+<th class='title' colspan='3'><RangeFilter>'s attributes</th>
+</tr>
+<tr><th colspan='3' height='1' class='ruler'></th></tr>
+<tr>
+<th class='subtitle'>Name</th><th class='subtitle'>Values</th><th class='subtitle'>Default</th></tr>
+<tr><th colspan='3' height='1' class='ruler'></th></tr>
+<tr><td><a href='#RangeFilter_fieldName'>fieldName</a></td><td></td><td></td></tr><tr><td><a href='#RangeFilter_includeLower'>includeLower</a></td><td>true, false</td><td>true</td></tr><tr><td><a href='#RangeFilter_includeUpper'>includeUpper</a></td><td>true, false</td><td>true</td></tr><tr><td><a href='#RangeFilter_lowerTerm'>lowerTerm</a></td><td></td><td></td></tr><tr><td><a href='#RangeFilter_upperTerm'>upperTerm</a></td><td></td><td></td></tr></table></blockquote>
+<p class='emptyTagNote'>This element is always empty.</p><a name='RangeFilter_fieldName'></a>
+<br /><table class='attributeTitle' summary="fieldName"><tr><td class='leftAttributeTitle'>
+@fieldName</td><td class='rightAttributeTitle'>
+Attribute of <a href='#RangeFilter'>RangeFilter</a>
+</td></tr></table>
+<p>fieldName must be defined here or is taken from the most immediate parent XML element that defines a "fieldName" attribute</p><a name='RangeFilter_lowerTerm'></a>
+<br /><table class='attributeTitle' summary="lowerTerm"><tr><td class='leftAttributeTitle'>
+@lowerTerm</td><td class='rightAttributeTitle'>
+Attribute of <a href='#RangeFilter'>RangeFilter</a>
+</td></tr></table>
+<p>The lower-most term value for this field (must be <= upperTerm)</p><p><span class='inTextTitle'>Required</span></p><a name='RangeFilter_upperTerm'></a>
+<br /><table class='attributeTitle' summary="upperTerm"><tr><td class='leftAttributeTitle'>
+@upperTerm</td><td class='rightAttributeTitle'>
+Attribute of <a href='#RangeFilter'>RangeFilter</a>
+</td></tr></table>
+<p>The upper-most term value for this field (must be >= lowerTerm)</p><p><span class='inTextTitle'>Required</span></p><a name='RangeFilter_includeLower'></a>
+<br /><table class='attributeTitle' summary="includeLower"><tr><td class='leftAttributeTitle'>
+@includeLower</td><td class='rightAttributeTitle'>
+Attribute of <a href='#RangeFilter'>RangeFilter</a>
+</td></tr></table>
+<p>Controls if the lowerTerm in the range is part of the allowed set of values</p><p><span class='inTextTitle'>Possible values</span>: true, false - <span class='inTextTitle'>Default value</span>: true</p><a name='RangeFilter_includeUpper'></a>
+<br /><table class='attributeTitle' summary="includeUpper"><tr><td class='leftAttributeTitle'>
+@includeUpper</td><td class='rightAttributeTitle'>
+Attribute of <a href='#RangeFilter'>RangeFilter</a>
+</td></tr></table>
+<p>Controls if the upperTerm in the range is part of the allowed set of values</p><p><span class='inTextTitle'>Possible values</span>: true, false - <span class='inTextTitle'>Default value</span>: true</p><a name='SpanTerm'></a>
+<br /><table class='elementTitle' summary="SpanTerm"><tr><td class='leftElementTitle'>
+<SpanTerm></td><td class='rightElementTitle'>
+Child of <a href='#Include'>Include</a>, <a href='#Exclude'>Exclude</a>, <a href='#Clause'>Clause</a>, <a href='#SpanOr'>SpanOr</a>, <a href='#BoostQuery'>BoostQuery</a>, <a href='#SpanFirst'>SpanFirst</a>, <a href='#Query'>Query</a>, <a href='#CachedFilter'>CachedFilter</a>, <a href='#SpanNear'>SpanNear</a>
+</td></tr></table>
+<p>A single term used in a SpanQuery. These clauses are the building blocks for more complex "span" queries which test word proximity</p><p><span class='inTextTitle'>Example:</span> <em>Find documents using terms close to each other about mining and accidents</em>
+</p><pre>
+ <SpanNear slop="8" inOrder="false" fieldName="text">
+ <SpanOr>
+ <SpanTerm>killed</SpanTerm>
+ <SpanTerm>died</SpanTerm>
+ <SpanTerm>dead</SpanTerm>
+ </SpanOr>
+ <SpanOr>
+ <SpanTerm>miner</SpanTerm>
+ <SpanTerm>mining</SpanTerm>
+ <SpanTerm>miners</SpanTerm>
+ </SpanOr>
+ </SpanNear>
+ </pre><p></p><blockquote><table summary='element info'><tr>
+<td class='construct'><table summary="<SpanTerm>'s attributes"><tr>
+<th class='title' colspan='3'><SpanTerm>'s attributes</th>
+</tr>
+<tr><th colspan='3' height='1' class='ruler'></th></tr>
+<tr>
+<th class='subtitle'>Name</th><th class='subtitle'>Values</th><th class='subtitle'>Default</th></tr>
+<tr><th colspan='3' height='1' class='ruler'></th></tr>
+<tr><td><a href='#SpanTerm_fieldName'>fieldName</a></td><td></td><td></td></tr></table></td></tr></table></blockquote>
+<a name='SpanTerm_fieldName'></a>
+<br /><table class='attributeTitle' summary="fieldName"><tr><td class='leftAttributeTitle'>
+@fieldName</td><td class='rightAttributeTitle'>
+Attribute of <a href='#SpanTerm'>SpanTerm</a>
+</td></tr></table>
+<p>fieldName must be defined here or is taken from the most immediate parent XML element that defines a "fieldName" attribute</p><p><span class='inTextTitle'>Required</span></p><a name='SpanOrTerms'></a>
+<br /><table class='elementTitle' summary="SpanOrTerms"><tr><td class='leftElementTitle'>
+<SpanOrTerms></td><td class='rightElementTitle'>
+Child of <a href='#Include'>Include</a>, <a href='#Exclude'>Exclude</a>, <a href='#Clause'>Clause</a>, <a href='#SpanOr'>SpanOr</a>, <a href='#BoostQuery'>BoostQuery</a>, <a href='#SpanFirst'>SpanFirst</a>, <a href='#Query'>Query</a>, <a href='#CachedFilter'>CachedFilter</a>, <a href='#SpanNear'>SpanNear</a>
+</td></tr></table>
+<p>A field-specific analyzer is used here to parse the child text provided in this tag. The SpanTerms produced are ORed in terms of Boolean logic</p><p><span class='inTextTitle'>Example:</span> <em>Use SpanOrTerms as a more convenient/succinct way of expressing multiple choices of SpanTerms. This example looks for reports
+using words describing a fatality near to references to miners</em>
+</p><pre>
+ <SpanNear slop="8" inOrder="false" fieldName="text">
+ <SpanOrTerms>killed died death dead deaths</SpanOrTerms>
+ <SpanOrTerms>miner mining miners</SpanOrTerms>
+ </SpanNear>
+ </pre><p></p><blockquote><table summary='element info'><tr>
+<td class='construct'><table summary="<SpanOrTerms>'s attributes"><tr>
+<th class='title' colspan='3'><SpanOrTerms>'s attributes</th>
+</tr>
+<tr><th colspan='3' height='1' class='ruler'></th></tr>
+<tr>
+<th class='subtitle'>Name</th><th class='subtitle'>Values</th><th class='subtitle'>Default</th></tr>
+<tr><th colspan='3' height='1' class='ruler'></th></tr>
+<tr><td><a href='#SpanOrTerms_fieldName'>fieldName</a></td><td></td><td></td></tr></table></td></tr></table></blockquote>
+<a name='SpanOrTerms_fieldName'></a>
+<br /><table class='attributeTitle' summary="fieldName"><tr><td class='leftAttributeTitle'>
+@fieldName</td><td class='rightAttributeTitle'>
+Attribute of <a href='#SpanOrTerms'>SpanOrTerms</a>
+</td></tr></table>
+<p>fieldName must be defined here or is taken from the most immediate parent XML element that defines a "fieldName" attribute</p><p><span class='inTextTitle'>Required</span></p><a name='SpanOr'></a>
+<br /><table class='elementTitle' summary="SpanOr"><tr><td class='leftElementTitle'>
+<SpanOr></td><td class='rightElementTitle'>
+Child of <a href='#Include'>Include</a>, <a href='#Exclude'>Exclude</a>, <a href='#Clause'>Clause</a>, <a href='#BoostQuery'>BoostQuery</a>, <a href='#SpanFirst'>SpanFirst</a>, <a href='#Query'>Query</a>, <a href='#CachedFilter'>CachedFilter</a>, <a href='#SpanNear'>SpanNear</a>
+</td></tr></table>
+<p>Takes any number of child queries from the Span family</p><p><span class='inTextTitle'>Example:</span> <em>Find documents using terms close to each other about mining and accidents</em>
+</p><pre>
+ <SpanNear slop="8" inOrder="false" fieldName="text">
+ <SpanOr>
+ <SpanTerm>killed</SpanTerm>
+ <SpanTerm>died</SpanTerm>
+ <SpanTerm>dead</SpanTerm>
+ </SpanOr>
+ <SpanOr>
+ <SpanTerm>miner</SpanTerm>
+ <SpanTerm>mining</SpanTerm>
+ <SpanTerm>miners</SpanTerm>
+ </SpanOr>
+ </SpanNear>
+ </pre><p></p><blockquote><table summary='element info'><tr>
+<td class='construct'><table summary="<SpanOr>'s children">
+<thead>
+<tr><th class='title' colspan='2'><SpanOr>'s children</th></tr>
+<tr><th colspan='2' height='1' class='ruler'></th></tr>
+<tr><th class='subtitle'>Name</th><th class='subtitle'>Cardinality</th></tr>
+<tr><th colspan='2' height='1' class='ruler'></th></tr>
+</thead>
+<tbody><tr><td><a href='#SpanFirst'>SpanFirst</a></td><td>Any number</td></tr>
+<tr><td><a href='#SpanNear'>SpanNear</a></td><td>Any number</td></tr>
+<tr><td><a href='#SpanNot'>SpanNot</a></td><td>Any number</td></tr>
+<tr><td><a href='#SpanOr'>SpanOr</a></td><td>Any number</td></tr>
+<tr><td><a href='#SpanOrTerms'>SpanOrTerms</a></td><td>Any number</td></tr>
+<tr><td><a href='#SpanTerm'>SpanTerm</a></td><td>Any number</td></tr>
+</tbody></table></td></tr></table></blockquote>
+<span class='inTextTitle'>Element's model:</span><p class='model'>(<a href='#SpanOr'>SpanOr</a> | <a href='#SpanNear'>SpanNear</a> | <a href='#SpanOrTerms'>SpanOrTerms</a> | <a href='#SpanFirst'>SpanFirst</a> | <a href='#SpanNot'>SpanNot</a> | <a href='#SpanTerm'>SpanTerm</a>)*</p><a name='SpanNear'></a>
+<br /><table class='elementTitle' summary="SpanNear"><tr><td class='leftElementTitle'>
+<SpanNear></td><td class='rightElementTitle'>
+Child of <a href='#Include'>Include</a>, <a href='#Exclude'>Exclude</a>, <a href='#Clause'>Clause</a>, <a href='#SpanOr'>SpanOr</a>, <a href='#BoostQuery'>BoostQuery</a>, <a href='#SpanFirst'>SpanFirst</a>, <a href='#Query'>Query</a>, <a href='#CachedFilter'>CachedFilter</a>
+</td></tr></table>
+<p>Takes any number of child queries from the Span family and tests for proximity</p><blockquote><table summary='element info'><tr>
+<td class='construct'><table summary="<SpanNear>'s children">
+<thead>
+<tr><th class='title' colspan='2'><SpanNear>'s children</th></tr>
+<tr><th colspan='2' height='1' class='ruler'></th></tr>
+<tr><th class='subtitle'>Name</th><th class='subtitle'>Cardinality</th></tr>
+<tr><th colspan='2' height='1' class='ruler'></th></tr>
+</thead>
+<tbody><tr><td><a href='#SpanFirst'>SpanFirst</a></td><td>Any number</td></tr>
+<tr><td><a href='#SpanNear'>SpanNear</a></td><td>Any number</td></tr>
+<tr><td><a href='#SpanNot'>SpanNot</a></td><td>Any number</td></tr>
+<tr><td><a href='#SpanOr'>SpanOr</a></td><td>Any number</td></tr>
+<tr><td><a href='#SpanOrTerms'>SpanOrTerms</a></td><td>Any number</td></tr>
+<tr><td><a href='#SpanTerm'>SpanTerm</a></td><td>Any number</td></tr>
+</tbody></table></td><td class='construct'><table summary="<SpanNear>'s attributes"><tr>
+<th class='title' colspan='3'><SpanNear>'s attributes</th>
+</tr>
+<tr><th colspan='3' height='1' class='ruler'></th></tr>
+<tr>
+<th class='subtitle'>Name</th><th class='subtitle'>Values</th><th class='subtitle'>Default</th></tr>
+<tr><th colspan='3' height='1' class='ruler'></th></tr>
+<tr><td><a href='#SpanNear_inOrder'>inOrder</a></td><td>true, false</td><td>true</td></tr><tr><td><a href='#SpanNear_slop'>slop</a></td><td></td><td></td></tr></table></td></tr></table></blockquote>
+<span class='inTextTitle'>Element's model:</span><p class='model'>(<a href='#SpanOr'>SpanOr</a> | <a href='#SpanNear'>SpanNear</a> | <a href='#SpanOrTerms'>SpanOrTerms</a> | <a href='#SpanFirst'>SpanFirst</a> | <a href='#SpanNot'>SpanNot</a> | <a href='#SpanTerm'>SpanTerm</a>)*</p><a name='SpanNear_slop'></a>
+<br /><table class='attributeTitle' summary="slop"><tr><td class='leftAttributeTitle'>
+@slop</td><td class='rightAttributeTitle'>
+Attribute of <a href='#SpanNear'>SpanNear</a>
+</td></tr></table>
+<p>defines the maximum distance between Span elements where distance is expressed as word number, not byte offset</p><p><span class='inTextTitle'>Example:</span> <em>Find documents using terms within 8 words of each other talking about mining and accidents</em>
+</p><pre>
+ <SpanNear slop="8" inOrder="false" fieldName="text">
+ <SpanOr>
+ <SpanTerm>killed</SpanTerm>
+ <SpanTerm>died</SpanTerm>
+ <SpanTerm>dead</SpanTerm>
+ </SpanOr>
+ <SpanOr>
+ <SpanTerm>miner</SpanTerm>
+ <SpanTerm>mining</SpanTerm>
+ <SpanTerm>miners</SpanTerm>
+ </SpanOr>
+ </SpanNear>
+ </pre><p></p><p><span class='inTextTitle'>Required</span></p><a name='SpanNear_inOrder'></a>
+<br /><table class='attributeTitle' summary="inOrder"><tr><td class='leftAttributeTitle'>
+@inOrder</td><td class='rightAttributeTitle'>
+Attribute of <a href='#SpanNear'>SpanNear</a>
+</td></tr></table>
+<p>Controls if matching terms have to appear in the order listed or can be reversed</p><p><span class='inTextTitle'>Possible values</span>: true, false - <span class='inTextTitle'>Default value</span>: true</p><a name='SpanFirst'></a>
+<br /><table class='elementTitle' summary="SpanFirst"><tr><td class='leftElementTitle'>
+<SpanFirst></td><td class='rightElementTitle'>
+Child of <a href='#Include'>Include</a>, <a href='#Exclude'>Exclude</a>, <a href='#Clause'>Clause</a>, <a href='#SpanOr'>SpanOr</a>, <a href='#BoostQuery'>BoostQuery</a>, <a href='#Query'>Query</a>, <a href='#CachedFilter'>CachedFilter</a>, <a href='#SpanNear'>SpanNear</a>
+</td></tr></table>
+<p>Looks for a SpanQuery match occuring near the beginning of a document</p><p><span class='inTextTitle'>Example:</span> <em>Find letters where the first 50 words talk about a resignation:</em>
+</p><pre>
+ <SpanFirst end="50">
+ <SpanOrTerms fieldName="text">resigning resign leave</SpanOrTerms>
+ </SpanFirst>
+ </pre><p></p><blockquote><table summary='element info'><tr>
+<td class='construct'><table summary="<SpanFirst>'s children">
+<thead>
+<tr><th class='title' colspan='2'><SpanFirst>'s children</th></tr>
+<tr><th colspan='2' height='1' class='ruler'></th></tr>
+<tr><th class='subtitle'>Name</th><th class='subtitle'>Cardinality</th></tr>
+<tr><th colspan='2' height='1' class='ruler'></th></tr>
+</thead>
+<tbody><tr><td><a href='#SpanFirst'>SpanFirst</a></td><td>One or none</td></tr>
+<tr><td><a href='#SpanNear'>SpanNear</a></td><td>One or none</td></tr>
+<tr><td><a href='#SpanNot'>SpanNot</a></td><td>One or none</td></tr>
+<tr><td><a href='#SpanOr'>SpanOr</a></td><td>One or none</td></tr>
+<tr><td><a href='#SpanOrTerms'>SpanOrTerms</a></td><td>One or none</td></tr>
+<tr><td><a href='#SpanTerm'>SpanTerm</a></td><td>One or none</td></tr>
+</tbody></table></td><td class='construct'><table summary="<SpanFirst>'s attributes"><tr>
+<th class='title' colspan='3'><SpanFirst>'s attributes</th>
+</tr>
+<tr><th colspan='3' height='1' class='ruler'></th></tr>
+<tr>
+<th class='subtitle'>Name</th><th class='subtitle'>Values</th><th class='subtitle'>Default</th></tr>
+<tr><th colspan='3' height='1' class='ruler'></th></tr>
+<tr><td><a href='#SpanFirst_boost'>boost</a></td><td></td><td>1.0</td></tr><tr><td><a href='#SpanFirst_end'>end</a></td><td></td><td></td></tr></table></td></tr></table></blockquote>
+<span class='inTextTitle'>Element's model:</span><p class='model'>(<a href='#SpanOr'>SpanOr</a> | <a href='#SpanNear'>SpanNear</a> | <a href='#SpanOrTerms'>SpanOrTerms</a> | <a href='#SpanFirst'>SpanFirst</a> | <a href='#SpanNot'>SpanNot</a> | <a href='#SpanTerm'>SpanTerm</a>)</p><a name='SpanFirst_end'></a>
+<br /><table class='attributeTitle' summary="end"><tr><td class='leftAttributeTitle'>
+@end</td><td class='rightAttributeTitle'>
+Attribute of <a href='#SpanFirst'>SpanFirst</a>
+</td></tr></table>
+<p>Controls the end of the region considered in a document's field (expressed in word number, not byte offset)</p><p><span class='inTextTitle'>Required</span></p><a name='SpanFirst_boost'></a>
+<br /><table class='attributeTitle' summary="boost"><tr><td class='leftAttributeTitle'>
+@boost</td><td class='rightAttributeTitle'>
+Attribute of <a href='#SpanFirst'>SpanFirst</a>
+</td></tr></table>
+<p>Optional boost for matches on this query. Values > 1</p><p><span class='inTextTitle'>Default value</span>: 1.0</p><a name='SpanNot'></a>
+<br /><table class='elementTitle' summary="SpanNot"><tr><td class='leftElementTitle'>
+<SpanNot></td><td class='rightElementTitle'>
+Child of <a href='#Include'>Include</a>, <a href='#Exclude'>Exclude</a>, <a href='#Clause'>Clause</a>, <a href='#SpanOr'>SpanOr</a>, <a href='#BoostQuery'>BoostQuery</a>, <a href='#SpanFirst'>SpanFirst</a>, <a href='#Query'>Query</a>, <a href='#CachedFilter'>CachedFilter</a>, <a href='#SpanNear'>SpanNear</a>
+</td></tr></table>
+<p>Finds documents matching a SpanQuery but not if matching another SpanQuery</p><p><span class='inTextTitle'>Example:</span> <em>Find documents talking about social services but not containing the word "public"</em>
+</p><pre>
+ <SpanNot fieldName="text">
+ <Include>
+ <SpanNear slop="2" inOrder="true">
+ <SpanTerm>social</SpanTerm>
+ <SpanTerm>services</SpanTerm>
+ </SpanNear>
+ </Include>
+ <Exclude>
+ <SpanTerm>public</SpanTerm>
+ </Exclude>
+ </SpanNot>
+ </pre><p></p><blockquote><table summary='element info'><tr>
+<td class='construct'><table summary="<SpanNot>'s children">
+<thead>
+<tr><th class='title' colspan='2'><SpanNot>'s children</th></tr>
+<tr><th colspan='2' height='1' class='ruler'></th></tr>
+<tr><th class='subtitle'>Name</th><th class='subtitle'>Cardinality</th></tr>
+<tr><th colspan='2' height='1' class='ruler'></th></tr>
+</thead>
+<tbody><tr><td><a href='#Exclude'>Exclude</a></td><td>Only one</td></tr>
+<tr><td><a href='#Include'>Include</a></td><td>Only one</td></tr>
+</tbody></table></td></tr></table></blockquote>
+<span class='inTextTitle'>Element's model:</span><p class='model'>(<a href='#Include'>Include</a>, <a href='#Exclude'>Exclude</a>)</p><a name='Include'></a>
+<br /><table class='elementTitle' summary="Include"><tr><td class='leftElementTitle'>
+<Include></td><td class='rightElementTitle'>
+Child of <a href='#SpanNot'>SpanNot</a>
+</td></tr></table>
+<p>The SpanQuery to find</p><blockquote><table summary='element info'><tr>
+<td class='construct'><table summary="<Include>'s children">
+<thead>
+<tr><th class='title' colspan='2'><Include>'s children</th></tr>
+<tr><th colspan='2' height='1' class='ruler'></th></tr>
+<tr><th class='subtitle'>Name</th><th class='subtitle'>Cardinality</th></tr>
+<tr><th colspan='2' height='1' class='ruler'></th></tr>
+</thead>
+<tbody><tr><td><a href='#SpanFirst'>SpanFirst</a></td><td>One or none</td></tr>
+<tr><td><a href='#SpanNear'>SpanNear</a></td><td>One or none</td></tr>
+<tr><td><a href='#SpanNot'>SpanNot</a></td><td>One or none</td></tr>
+<tr><td><a href='#SpanOr'>SpanOr</a></td><td>One or none</td></tr>
+<tr><td><a href='#SpanOrTerms'>SpanOrTerms</a></td><td>One or none</td></tr>
+<tr><td><a href='#SpanTerm'>SpanTerm</a></td><td>One or none</td></tr>
+</tbody></table></td></tr></table></blockquote>
+<span class='inTextTitle'>Element's model:</span><p class='model'>(<a href='#SpanOr'>SpanOr</a> | <a href='#SpanNear'>SpanNear</a> | <a href='#SpanOrTerms'>SpanOrTerms</a> | <a href='#SpanFirst'>SpanFirst</a> | <a href='#SpanNot'>SpanNot</a> | <a href='#SpanTerm'>SpanTerm</a>)</p><a name='Exclude'></a>
+<br /><table class='elementTitle' summary="Exclude"><tr><td class='leftElementTitle'>
+<Exclude></td><td class='rightElementTitle'>
+Child of <a href='#SpanNot'>SpanNot</a>
+</td></tr></table>
+<p>The SpanQuery to be avoided</p><blockquote><table summary='element info'><tr>
+<td class='construct'><table summary="<Exclude>'s children">
+<thead>
+<tr><th class='title' colspan='2'><Exclude>'s children</th></tr>
+<tr><th colspan='2' height='1' class='ruler'></th></tr>
+<tr><th class='subtitle'>Name</th><th class='subtitle'>Cardinality</th></tr>
+<tr><th colspan='2' height='1' class='ruler'></th></tr>
+</thead>
+<tbody><tr><td><a href='#SpanFirst'>SpanFirst</a></td><td>One or none</td></tr>
+<tr><td><a href='#SpanNear'>SpanNear</a></td><td>One or none</td></tr>
+<tr><td><a href='#SpanNot'>SpanNot</a></td><td>One or none</td></tr>
+<tr><td><a href='#SpanOr'>SpanOr</a></td><td>One or none</td></tr>
+<tr><td><a href='#SpanOrTerms'>SpanOrTerms</a></td><td>One or none</td></tr>
+<tr><td><a href='#SpanTerm'>SpanTerm</a></td><td>One or none</td></tr>
+</tbody></table></td></tr></table></blockquote>
+<span class='inTextTitle'>Element's model:</span><p class='model'>(<a href='#SpanOr'>SpanOr</a> | <a href='#SpanNear'>SpanNear</a> | <a href='#SpanOrTerms'>SpanOrTerms</a> | <a href='#SpanFirst'>SpanFirst</a> | <a href='#SpanNot'>SpanNot</a> | <a href='#SpanTerm'>SpanTerm</a>)</p><a name='ConstantScoreQuery'></a>
+<br /><table class='elementTitle' summary="ConstantScoreQuery"><tr><td class='leftElementTitle'>
+<ConstantScoreQuery></td><td class='rightElementTitle'>
+Child of <a href='#Clause'>Clause</a>, <a href='#BoostQuery'>BoostQuery</a>, <a href='#Query'>Query</a>, <a href='#CachedFilter'>CachedFilter</a>
+</td></tr></table>
+<p>a utility tag to wrap any filter as a query</p><p><span class='inTextTitle'>Example:</span> <em> Find all documents from the last 10 years </em>
+</p><pre>
+ <ConstantScoreQuery>
+ <RangeFilter fieldName="date" lowerTerm="19970101" upperTerm="20070101"/>
+ </ConstantScoreQuery>
+ </pre><p></p><blockquote><table summary='element info'><tr>
+<td class='construct'><table summary="<ConstantScoreQuery>'s children">
+<thead>
+<tr><th class='title' colspan='2'><ConstantScoreQuery>'s children</th></tr>
+<tr><th colspan='2' height='1' class='ruler'></th></tr>
+<tr><th class='subtitle'>Name</th><th class='subtitle'>Cardinality</th></tr>
+<tr><th colspan='2' height='1' class='ruler'></th></tr>
+</thead>
+<tbody><tr><td><a href='#BooleanFilter'>BooleanFilter</a></td><td>Any number</td></tr>
+<tr><td><a href='#CachedFilter'>CachedFilter</a></td><td>Any number</td></tr>
+<tr><td><a href='#DuplicateFilter'>DuplicateFilter</a></td><td>Any number</td></tr>
+<tr><td><a href='#RangeFilter'>RangeFilter</a></td><td>Any number</td></tr>
+<tr><td><a href='#TermsFilter'>TermsFilter</a></td><td>Any number</td></tr>
+</tbody></table></td><td class='construct'><table summary="<ConstantScoreQuery>'s attributes"><tr>
+<th class='title' colspan='3'><ConstantScoreQuery>'s attributes</th>
+</tr>
+<tr><th colspan='3' height='1' class='ruler'></th></tr>
+<tr>
+<th class='subtitle'>Name</th><th class='subtitle'>Values</th><th class='subtitle'>Default</th></tr>
+<tr><th colspan='3' height='1' class='ruler'></th></tr>
+<tr><td><a href='#ConstantScoreQuery_boost'>boost</a></td><td></td><td>1.0</td></tr></table></td></tr></table></blockquote>
+<span class='inTextTitle'>Element's model:</span><p class='model'>(<a href='#RangeFilter'>RangeFilter</a> | <a href='#CachedFilter'>CachedFilter</a> | <a href='#TermsFilter'>TermsFilter</a> | <a href='#BooleanFilter'>BooleanFilter</a> | <a href='#DuplicateFilter'>DuplicateFilter</a>)*</p><a name='ConstantScoreQuery_boost'></a>
+<br /><table class='attributeTitle' summary="boost"><tr><td class='leftAttributeTitle'>
+@boost</td><td class='rightAttributeTitle'>
+Attribute of <a href='#ConstantScoreQuery'>ConstantScoreQuery</a>
+</td></tr></table>
+<p>Optional boost for matches on this query. Values > 1</p><p><span class='inTextTitle'>Default value</span>: 1.0</p><a name='FuzzyLikeThisQuery'></a>
+<br /><table class='elementTitle' summary="FuzzyLikeThisQuery"><tr><td class='leftElementTitle'>
+<FuzzyLikeThisQuery></td><td class='rightElementTitle'>
+Child of <a href='#Clause'>Clause</a>, <a href='#BoostQuery'>BoostQuery</a>, <a href='#Query'>Query</a>, <a href='#CachedFilter'>CachedFilter</a>
+</td></tr></table>
+<p>Performs fuzzy matching on "significant" terms in fields. Improves on "LikeThisQuery" by allowing for fuzzy variations of supplied fields.
+Improves on FuzzyQuery by rewarding all fuzzy variants of a term with the same IDF rather than default fuzzy behaviour which ranks rarer
+variants (typically misspellings) more highly. This can be a useful default search mode for processing user input where the end user
+is not expected to know about the standard query operators for fuzzy, boolean or phrase logic found in UserQuery</p><p><span class='inTextTitle'>Example:</span> <em>Search for information about the Sumitomo bank, where the end user has mis-spelt the name</em>
+</p><pre>
+ <FuzzyLikeThisQuery>
+ <Field fieldName="contents">
+ Sumitimo bank
+ </Field>
+ </FuzzyLikeThisQuery>
+ </pre><p></p><blockquote><table summary='element info'><tr>
+<td class='construct'><table summary="<FuzzyLikeThisQuery>'s children">
+<thead>
+<tr><th class='title' colspan='2'><FuzzyLikeThisQuery>'s children</th></tr>
+<tr><th colspan='2' height='1' class='ruler'></th></tr>
+<tr><th class='subtitle'>Name</th><th class='subtitle'>Cardinality</th></tr>
+<tr><th colspan='2' height='1' class='ruler'></th></tr>
+</thead>
+<tbody><tr><td><a href='#Field'>Field</a></td><td>Any number</td></tr>
+</tbody></table></td><td class='construct'><table summary="<FuzzyLikeThisQuery>'s attributes"><tr>
+<th class='title' colspan='3'><FuzzyLikeThisQuery>'s attributes</th>
+</tr>
+<tr><th colspan='3' height='1' class='ruler'></th></tr>
+<tr>
+<th class='subtitle'>Name</th><th class='subtitle'>Values</th><th class='subtitle'>Default</th></tr>
+<tr><th colspan='3' height='1' class='ruler'></th></tr>
+<tr><td><a href='#FuzzyLikeThisQuery_boost'>boost</a></td><td></td><td>1.0</td></tr><tr><td><a href='#FuzzyLikeThisQuery_ignoreTF'>ignoreTF</a></td><td>true, false</td><td>false</td></tr><tr><td><a href='#FuzzyLikeThisQuery_maxNumTerms'>maxNumTerms</a></td><td></td><td>50</td></tr></table></td></tr></table></blockquote>
+<span class='inTextTitle'>Element's model:</span><p class='model'>(<a href='#Field'>Field</a>)*</p><a name='FuzzyLikeThisQuery_boost'></a>
+<br /><table class='attributeTitle' summary="boost"><tr><td class='leftAttributeTitle'>
+@boost</td><td class='rightAttributeTitle'>
+Attribute of <a href='#FuzzyLikeThisQuery'>FuzzyLikeThisQuery</a>
+</td></tr></table>
+<p>Optional boost for matches on this query. Values > 1</p><p><span class='inTextTitle'>Default value</span>: 1.0</p><a name='FuzzyLikeThisQuery_maxNumTerms'></a>
+<br /><table class='attributeTitle' summary="maxNumTerms"><tr><td class='leftAttributeTitle'>
+@maxNumTerms</td><td class='rightAttributeTitle'>
+Attribute of <a href='#FuzzyLikeThisQuery'>FuzzyLikeThisQuery</a>
+</td></tr></table>
+<p>Limits the total number of terms selected from the provided text plus the selected "fuzzy" variants</p><p><span class='inTextTitle'>Default value</span>: 50</p><a name='FuzzyLikeThisQuery_ignoreTF'></a>
+<br /><table class='attributeTitle' summary="ignoreTF"><tr><td class='leftAttributeTitle'>
+@ignoreTF</td><td class='rightAttributeTitle'>
+Attribute of <a href='#FuzzyLikeThisQuery'>FuzzyLikeThisQuery</a>
+</td></tr></table>
+<p>Ignore "Term Frequency" - a boost factor which rewards multiple occurences of the same term in a document</p><p><span class='inTextTitle'>Possible values</span>: true, false - <span class='inTextTitle'>Default value</span>: false</p><a name='Field'></a>
+<br /><table class='elementTitle' summary="Field"><tr><td class='leftElementTitle'>
+<Field></td><td class='rightElementTitle'>
+Child of <a href='#FuzzyLikeThisQuery'>FuzzyLikeThisQuery</a>
+</td></tr></table>
+<p>A field used in a FuzzyLikeThisQuery</p><blockquote><table summary='element info'><tr>
+<td class='construct'><table summary="<Field>'s attributes"><tr>
+<th class='title' colspan='3'><Field>'s attributes</th>
+</tr>
+<tr><th colspan='3' height='1' class='ruler'></th></tr>
+<tr>
+<th class='subtitle'>Name</th><th class='subtitle'>Values</th><th class='subtitle'>Default</th></tr>
+<tr><th colspan='3' height='1' class='ruler'></th></tr>
+<tr><td><a href='#Field_fieldName'>fieldName</a></td><td></td><td></td></tr><tr><td><a href='#Field_minSimilarity'>minSimilarity</a></td><td></td><td>0.5</td></tr><tr><td><a href='#Field_prefixLength'>prefixLength</a></td><td></td><td>1</td></tr></table></td></tr></table></blockquote>
+<a name='Field_minSimilarity'></a>
+<br /><table class='attributeTitle' summary="minSimilarity"><tr><td class='leftAttributeTitle'>
+@minSimilarity</td><td class='rightAttributeTitle'>
+Attribute of <a href='#Field'>Field</a>
+</td></tr></table>
+<p>Controls the level of similarity required for fuzzy variants where 1 is identical and 0.5 is that the variant contains
+half of the original's characters in the same order. Lower values produce more results but may take longer to execute due to
+additional IO required to read matching document ids</p><p><span class='inTextTitle'>Default value</span>: 0.5</p><a name='Field_prefixLength'></a>
+<br /><table class='attributeTitle' summary="prefixLength"><tr><td class='leftAttributeTitle'>
+@prefixLength</td><td class='rightAttributeTitle'>
+Attribute of <a href='#Field'>Field</a>
+</td></tr></table>
+<p>Controls the minimum number of characters at the start of fuzzy variant words that must exactly match the original.
+A value of zero will require no minimum and the search software will effectively scan ALL terms from a to z looking for variations.
+This can incur high CPU overhead and a prefix length of just "1" will reduce this overhead to 1/26th of the original cost (assuming
+an even distribution of letters used from the alphabet).</p><p><span class='inTextTitle'>Default value</span>: 1</p><a name='Field_fieldName'></a>
+<br /><table class='attributeTitle' summary="fieldName"><tr><td class='leftAttributeTitle'>
+@fieldName</td><td class='rightAttributeTitle'>
+Attribute of <a href='#Field'>Field</a>
+</td></tr></table>
+<p>fieldName must be defined here or is taken from the most immediate parent XML element that defines a "fieldName" attribute</p><a name='LikeThisQuery'></a>
+<br /><table class='elementTitle' summary="LikeThisQuery"><tr><td class='leftElementTitle'>
+<LikeThisQuery></td><td class='rightElementTitle'>
+Child of <a href='#Clause'>Clause</a>, <a href='#BoostQuery'>BoostQuery</a>, <a href='#Query'>Query</a>, <a href='#CachedFilter'>CachedFilter</a>
+</td></tr></table>
+<p>Cherry-picks "significant" terms from the example child text and queries using these words. By only using significant (read: rare) terms the
+performance cost of the query is substantially reduced and large bodies of text can be used as example content.</p><p><span class='inTextTitle'>Example:</span> <em>Use a block of text as an example of the type of content to be found, ignoring the "Reuters" word which
+appears commonly in the index.</em>
+</p><pre>
+ <LikeThisQuery percentTermsToMatch="5" stopWords="Reuters">
+ IRAQI TROOPS REPORTED PUSHING BACK IRANIANS Iraq said today its troops were pushing Iranian forces out of
+ positions they had initially occupied when they launched a new offensive near the southern port of
+ Basra early yesterday. A High Command communique said Iraqi troops had won a significant victory
+ and were continuing to advance. Iraq said it had foiled a three-pronged thrust some 10 km
+ (six miles) from Basra, but admitted the Iranians had occupied ground held by the Mohammed al-Qassem
+ unit, one of three divisions attacked. The communique said Iranian Revolutionary Guards were under
+ assault from warplanes, helicopter gunships, heavy artillery and tanks. "Our forces are continuing
+ their advance until they purge the last foothold" occupied by the Iranians, it said.
+ (Iran said its troops had killed or wounded more than 4,000 Iraqis and were stabilising their new positions.)
+ The Baghdad communique said Iraqi planes also destroyed oil installations at Iran's southwestern Ahvaz field
+ during a raid today. It denied an Iranian report that an Iraqi jet was shot down.
+ Iraq also reported a naval battle at the northern tip of the Gulf. Iraqi naval units and forces defending an
+ offshore terminal sank six Iranian out of 28 Iranian boats attempting to attack an offshore terminal,
+ the communique said. Reuters 3;
+ </LikeThisQuery>
+ </pre><p></p><blockquote><table summary='element info'><tr>
+<td class='construct'><table summary="<LikeThisQuery>'s attributes"><tr>
+<th class='title' colspan='3'><LikeThisQuery>'s attributes</th>
+</tr>
+<tr><th colspan='3' height='1' class='ruler'></th></tr>
+<tr>
+<th class='subtitle'>Name</th><th class='subtitle'>Values</th><th class='subtitle'>Default</th></tr>
+<tr><th colspan='3' height='1' class='ruler'></th></tr>
+<tr><td><a href='#LikeThisQuery_boost'>boost</a></td><td></td><td>1.0</td></tr><tr><td><a href='#LikeThisQuery_fieldNames'>fieldNames</a></td><td></td><td></td></tr><tr><td><a href='#LikeThisQuery_maxQueryTerms'>maxQueryTerms</a></td><td></td><td>20</td></tr><tr><td><a href='#LikeThisQuery_minTermFrequency'>minTermFrequency</a></td><td></td><td>1</td></tr><tr><td><a href='#LikeThisQuery_percentTermsToMatch'>percentTermsToMatch</a></td><td></td><td>30</td></tr><tr><td><a href='#LikeThisQuery_stopWords'>stopWords</a></td><td></td><td></td></tr></table></td></tr></table></blockquote>
+<a name='LikeThisQuery_boost'></a>
+<br /><table class='attributeTitle' summary="boost"><tr><td class='leftAttributeTitle'>
+@boost</td><td class='rightAttributeTitle'>
+Attribute of <a href='#LikeThisQuery'>LikeThisQuery</a>
+</td></tr></table>
+<p>Optional boost for matches on this query. Values > 1</p><p><span class='inTextTitle'>Default value</span>: 1.0</p><a name='LikeThisQuery_fieldNames'></a>
+<br /><table class='attributeTitle' summary="fieldNames"><tr><td class='leftAttributeTitle'>
+@fieldNames</td><td class='rightAttributeTitle'>
+Attribute of <a href='#LikeThisQuery'>LikeThisQuery</a>
+</td></tr></table>
+<p>Comma delimited list of field names</p><a name='LikeThisQuery_stopWords'></a>
+<br /><table class='attributeTitle' summary="stopWords"><tr><td class='leftAttributeTitle'>
+@stopWords</td><td class='rightAttributeTitle'>
+Attribute of <a href='#LikeThisQuery'>LikeThisQuery</a>
+</td></tr></table>
+<p>a list of stop words - analyzed to produce stop terms</p><a name='LikeThisQuery_maxQueryTerms'></a>
+<br /><table class='attributeTitle' summary="maxQueryTerms"><tr><td class='leftAttributeTitle'>
+@maxQueryTerms</td><td class='rightAttributeTitle'>
+Attribute of <a href='#LikeThisQuery'>LikeThisQuery</a>
+</td></tr></table>
+<p>controls the maximum number of words shortlisted for the query. The higher the number the slower the response due to more disk reads required</p><p><span class='inTextTitle'>Default value</span>: 20</p><a name='LikeThisQuery_minTermFrequency'></a>
+<br /><table class='attributeTitle' summary="minTermFrequency"><tr><td class='leftAttributeTitle'>
+@minTermFrequency</td><td class='rightAttributeTitle'>
+Attribute of <a href='#LikeThisQuery'>LikeThisQuery</a>
+</td></tr></table>
+<p>Controls how many times a term must appear in the example text before it is shortlisted for use in the query</p><p><span class='inTextTitle'>Default value</span>: 1</p><a name='LikeThisQuery_percentTermsToMatch'></a>
+<br /><table class='attributeTitle' summary="percentTermsToMatch"><tr><td class='leftAttributeTitle'>
+@percentTermsToMatch</td><td class='rightAttributeTitle'>
+Attribute of <a href='#LikeThisQuery'>LikeThisQuery</a>
+</td></tr></table>
+<p>A quality control that can be used to limit the number of results to those documents matching a certain percentage of the shortlisted query terms.
+Values must be between 1 and 100</p><p><span class='inTextTitle'>Default value</span>: 30</p><a name='BoostingQuery'></a>
+<br /><table class='elementTitle' summary="BoostingQuery"><tr><td class='leftElementTitle'>
+<BoostingQuery></td><td class='rightElementTitle'>
+Child of <a href='#Clause'>Clause</a>, <a href='#BoostQuery'>BoostQuery</a>, <a href='#Query'>Query</a>, <a href='#CachedFilter'>CachedFilter</a>
+</td></tr></table>
+<p>Requires matches on the "Query" element and optionally boosts by any matches on the "BoostQuery".
+Unlike a regular BooleanQuery the boost can be less than 1 to produce a subtractive rather than additive result
+on the match score.</p><p><span class='inTextTitle'>Example:</span> <em>Find documents about banks, preferably related to mergers, and preferably not about "World bank"</em>
+</p><pre>
+ <BoostingQuery>
+ <Query>
+ <BooleanQuery fieldName="contents">
+ <Clause occurs="should">
+ <TermQuery>merger</TermQuery>
+ </Clause>
+ <Clause occurs="must">
+ <TermQuery>bank</TermQuery>
+ </Clause>
+ </BooleanQuery>
+ </Query>
+ <BoostQuery boost="0.01">
+ <UserQuery>"world bank"</UserQuery>
+ </BoostQuery>
+ </BoostingQuery>
+ </pre><p></p><blockquote><table summary='element info'><tr>
+<td class='construct'><table summary="<BoostingQuery>'s children">
+<thead>
+<tr><th class='title' colspan='2'><BoostingQuery>'s children</th></tr>
+<tr><th colspan='2' height='1' class='ruler'></th></tr>
+<tr><th class='subtitle'>Name</th><th class='subtitle'>Cardinality</th></tr>
+<tr><th colspan='2' height='1' class='ruler'></th></tr>
+</thead>
+<tbody><tr><td><a href='#BoostQuery'>BoostQuery</a></td><td>Only one</td></tr>
+<tr><td><a href='#Query'>Query</a></td><td>Only one</td></tr>
+</tbody></table></td><td class='construct'><table summary="<BoostingQuery>'s attributes"><tr>
+<th class='title' colspan='3'><BoostingQuery>'s attributes</th>
+</tr>
+<tr><th colspan='3' height='1' class='ruler'></th></tr>
+<tr>
+<th class='subtitle'>Name</th><th class='subtitle'>Values</th><th class='subtitle'>Default</th></tr>
+<tr><th colspan='3' height='1' class='ruler'></th></tr>
+<tr><td><a href='#BoostingQuery_boost'>boost</a></td><td></td><td>1.0</td></tr></table></td></tr></table></blockquote>
+<span class='inTextTitle'>Element's model:</span><p class='model'>(<a href='#Query'>Query</a>, <a href='#BoostQuery'>BoostQuery</a>)</p><a name='BoostingQuery_boost'></a>
+<br /><table class='attributeTitle' summary="boost"><tr><td class='leftAttributeTitle'>
+@boost</td><td class='rightAttributeTitle'>
+Attribute of <a href='#BoostingQuery'>BoostingQuery</a>
+</td></tr></table>
+<p>Optional boost for matches on this query. Values > 1</p><p><span class='inTextTitle'>Default value</span>: 1.0</p><a name='BoostQuery'></a>
+<br /><table class='elementTitle' summary="BoostQuery"><tr><td class='leftElementTitle'>
+<BoostQuery></td><td class='rightElementTitle'>
+Child of <a href='#BoostingQuery'>BoostingQuery</a>
+</td></tr></table>
+<p>Child element of BoostingQuery used to contain the choice of Query which is used for boosting purposes</p><blockquote><table summary='element info'><tr>
+<td class='construct'><table summary="<BoostQuery>'s children">
+<thead>
+<tr><th class='title' colspan='2'><BoostQuery>'s children</th></tr>
+<tr><th colspan='2' height='1' class='ruler'></th></tr>
+<tr><th class='subtitle'>Name</th><th class='subtitle'>Cardinality</th></tr>
+<tr><th colspan='2' height='1' class='ruler'></th></tr>
+</thead>
+<tbody><tr><td><a href='#BooleanQuery'>BooleanQuery</a></td><td>One or none</td></tr>
+<tr><td><a href='#BoostingQuery'>BoostingQuery</a></td><td>One or none</td></tr>
+<tr><td><a href='#ConstantScoreQuery'>ConstantScoreQuery</a></td><td>One or none</td></tr>
+<tr><td><a href='#FilteredQuery'>FilteredQuery</a></td><td>One or none</td></tr>
+<tr><td><a href='#FuzzyLikeThisQuery'>FuzzyLikeThisQuery</a></td><td>One or none</td></tr>
+<tr><td><a href='#LikeThisQuery'>LikeThisQuery</a></td><td>One or none</td></tr>
+<tr><td><a href='#MatchAllDocsQuery'>MatchAllDocsQuery</a></td><td>One or none</td></tr>
+<tr><td><a href='#SpanFirst'>SpanFirst</a></td><td>One or none</td></tr>
+<tr><td><a href='#SpanNear'>SpanNear</a></td><td>One or none</td></tr>
+<tr><td><a href='#SpanNot'>SpanNot</a></td><td>One or none</td></tr>
+<tr><td><a href='#SpanOr'>SpanOr</a></td><td>One or none</td></tr>
+<tr><td><a href='#SpanOrTerms'>SpanOrTerms</a></td><td>One or none</td></tr>
+<tr><td><a href='#SpanTerm'>SpanTerm</a></td><td>One or none</td></tr>
+<tr><td><a href='#TermQuery'>TermQuery</a></td><td>One or none</td></tr>
+<tr><td><a href='#TermsQuery'>TermsQuery</a></td><td>One or none</td></tr>
+<tr><td><a href='#UserQuery'>UserQuery</a></td><td>One or none</td></tr>
+</tbody></table></td><td class='construct'><table summary="<BoostQuery>'s attributes"><tr>
+<th class='title' colspan='3'><BoostQuery>'s attributes</th>
+</tr>
+<tr><th colspan='3' height='1' class='ruler'></th></tr>
+<tr>
+<th class='subtitle'>Name</th><th class='subtitle'>Values</th><th class='subtitle'>Default</th></tr>
+<tr><th colspan='3' height='1' class='ruler'></th></tr>
+<tr><td><a href='#BoostQuery_boost'>boost</a></td><td></td><td>1.0</td></tr></table></td></tr></table></blockquote>
+<span class='inTextTitle'>Element's model:</span><p class='model'>(<a href='#BooleanQuery'>BooleanQuery</a> | <a href='#UserQuery'>UserQuery</a> | <a href='#FilteredQuery'>FilteredQuery</a> | <a href='#TermQuery'>TermQuery</a> | <a href='#TermsQuery'>TermsQuery</a> | <a href='#MatchAllDocsQuery'>MatchAllDocsQuery</a> | <a href='#ConstantScoreQuery'>ConstantScoreQuery</a> | <a href='#SpanOr'>SpanOr</a> | <a href='#SpanNear'>SpanNear</a> | <a href='#SpanOrTerms'>SpanOrTerms</a> | <a href='#SpanFirst'>SpanFirst</a> | <a href='#SpanNot'>SpanNot</a> | <a href='#SpanTerm'>SpanTerm</a> | <a href='#LikeThisQuery'>LikeThisQuery</a> | <a href='#BoostingQuery'>BoostingQuery</a> | <a href='#FuzzyLikeThisQuery'>FuzzyLikeThisQuery</a>)</p><a name='BoostQuery_boost'></a>
+<br /><table class='attributeTitle' summary="boost"><tr><td class='leftAttributeTitle'>
+@boost</td><td class='rightAttributeTitle'>
+Attribute of <a href='#BoostQuery'>BoostQuery</a>
+</td></tr></table>
+<p>Optional boost for matches on this query. A boost of >0 but <1
+effectively demotes results from Query that match this BoostQuery.</p><p><span class='inTextTitle'>Default value</span>: 1.0</p><a name='DuplicateFilter'></a>
+<br /><table class='elementTitle' summary="DuplicateFilter"><tr><td class='leftElementTitle'>
+<DuplicateFilter/></td><td class='rightElementTitle'>
+Child of <a href='#Filter'>Filter</a>, <a href='#ConstantScoreQuery'>ConstantScoreQuery</a>, <a href='#Clause'>Clause</a>, <a href='#CachedFilter'>CachedFilter</a>
+</td></tr></table>
+<p>Removes duplicated documents from results where "duplicate" means documents share a value for a particular field such as a primary key</p><p><span class='inTextTitle'>Example:</span> <em>Find the latest version of each web page that mentions "Lucene"</em>
+</p><pre>
+ <FilteredQuery>
+ <Query>
+ <TermQuery fieldName="text">lucene</TermQuery>
+ </Query>
+ <Filter>
+ <DuplicateFilter fieldName="url" keepMode="last"/>
+ </Filter>
+ </FilteredQuery>
+ </pre><p></p><blockquote>
+<table summary="<DuplicateFilter>'s attributes"><tr>
+<th class='title' colspan='3'><DuplicateFilter>'s attributes</th>
+</tr>
+<tr><th colspan='3' height='1' class='ruler'></th></tr>
+<tr>
+<th class='subtitle'>Name</th><th class='subtitle'>Values</th><th class='subtitle'>Default</th></tr>
+<tr><th colspan='3' height='1' class='ruler'></th></tr>
+<tr><td><a href='#DuplicateFilter_fieldName'>fieldName</a></td><td></td><td></td></tr><tr><td><a href='#DuplicateFilter_keepMode'>keepMode</a></td><td>first, last</td><td>first</td></tr><tr><td><a href='#DuplicateFilter_processingMode'>processingMode</a></td><td>full, fast</td><td>full</td></tr></table></blockquote>
+<p class='emptyTagNote'>This element is always empty.</p><a name='DuplicateFilter_fieldName'></a>
+<br /><table class='attributeTitle' summary="fieldName"><tr><td class='leftAttributeTitle'>
+@fieldName</td><td class='rightAttributeTitle'>
+Attribute of <a href='#DuplicateFilter'>DuplicateFilter</a>
+</td></tr></table>
+<p>fieldName must be defined here or is taken from the most immediate parent XML element that defines a "fieldName" attribute</p><a name='DuplicateFilter_keepMode'></a>
+<br /><table class='attributeTitle' summary="keepMode"><tr><td class='leftAttributeTitle'>
+@keepMode</td><td class='rightAttributeTitle'>
+Attribute of <a href='#DuplicateFilter'>DuplicateFilter</a>
+</td></tr></table>
+<p>Determines if the first or last document occurence is the one to return when presented with duplicated field values</p><p><span class='inTextTitle'>Possible values</span>: first, last - <span class='inTextTitle'>Default value</span>: first</p><a name='DuplicateFilter_processingMode'></a>
+<br /><table class='attributeTitle' summary="processingMode"><tr><td class='leftAttributeTitle'>
+@processingMode</td><td class='rightAttributeTitle'>
+Attribute of <a href='#DuplicateFilter'>DuplicateFilter</a>
+</td></tr></table>
+<p>Controls the choice of process used to produce the filter - "full" mode identifies only non-duplicate documents with the chosen field
+while "fast" mode may perform faster but will also mark documents <em>without</em> the field as valid. The former approach starts by
+assuming every document is a duplicate then finds the "master" documents to keep while the latter approach assumes all documents are
+unique and unmarks those documents that are a copy.</p><p><span class='inTextTitle'>Possible values</span>: full, fast - <span class='inTextTitle'>Default value</span>: full</p><a name='TermsFilter'></a>
+<br /><table class='elementTitle' summary="TermsFilter"><tr><td class='leftElementTitle'>
+<TermsFilter></td><td class='rightElementTitle'>
+Child of <a href='#Filter'>Filter</a>, <a href='#ConstantScoreQuery'>ConstantScoreQuery</a>, <a href='#Clause'>Clause</a>, <a href='#CachedFilter'>CachedFilter</a>
+</td></tr></table>
+<p>Processes child text using a field-specific choice of Analyzer to produce a set of terms that are then used as a filter.</p><p><span class='inTextTitle'>Example:</span> <em>Find documents talking about Lucene written on a Monday or a Friday</em>
+</p><pre>
+ <FilteredQuery>
+ <Query>
+ <TermQuery fieldName="text">lucene</TermQuery>
+ </Query>
+ <Filter>
+ <TermsFilter fieldName="dayOfWeek">monday friday</TermsFilter>
+ </Filter>
+ </FilteredQuery>
+ </pre><p></p><blockquote><table summary='element info'><tr>
+<td class='construct'><table summary="<TermsFilter>'s attributes"><tr>
+<th class='title' colspan='3'><TermsFilter>'s attributes</th>
+</tr>
+<tr><th colspan='3' height='1' class='ruler'></th></tr>
+<tr>
+<th class='subtitle'>Name</th><th class='subtitle'>Values</th><th class='subtitle'>Default</th></tr>
+<tr><th colspan='3' height='1' class='ruler'></th></tr>
+<tr><td><a href='#TermsFilter_fieldName'>fieldName</a></td><td></td><td></td></tr></table></td></tr></table></blockquote>
+<a name='TermsFilter_fieldName'></a>
+<br /><table class='attributeTitle' summary="fieldName"><tr><td class='leftAttributeTitle'>
+@fieldName</td><td class='rightAttributeTitle'>
+Attribute of <a href='#TermsFilter'>TermsFilter</a>
+</td></tr></table>
+<p>fieldName must be defined here or is taken from the most immediate parent XML element that defines a "fieldName" attribute</p><a name='BooleanFilter'></a>
+<br /><table class='elementTitle' summary="BooleanFilter"><tr><td class='leftElementTitle'>
+<BooleanFilter></td><td class='rightElementTitle'>
+Child of <a href='#Filter'>Filter</a>, <a href='#ConstantScoreQuery'>ConstantScoreQuery</a>, <a href='#Clause'>Clause</a>, <a href='#CachedFilter'>CachedFilter</a>
+</td></tr></table>
+<p>A Filter equivalent to BooleanQuery that applies Boolean logic to Clauses containing Filters.
+Unlike BooleanQuery a BooleanFilter can contain a single "mustNot" clause.</p><p><span class='inTextTitle'>Example:</span> <em>Find documents from the first quarter of this year or last year that are not in "draft" status</em>
+</p><pre>
+ <FilteredQuery>
+ <Query>
+ <MatchAllDocsQuery/>
+ </Query>
+ <Filter>
+ <BooleanFilter>
+ <Clause occurs="should">
+ <RangeFilter fieldName="date" lowerTerm="20070101" upperTerm="20070401"/>
+ </Clause>
+ <Clause occurs="should">
+ <RangeFilter fieldName="date" lowerTerm="20060101" upperTerm="20060401"/>
+ </Clause>
+ <Clause occurs="mustNot">
+ <TermsFilter fieldName="status">draft</TermsFilter>
+ </Clause>
+ </BooleanFilter>
+ </Filter>
+ </FilteredQuery>
+ </pre><p></p><blockquote><table summary='element info'><tr>
+<td class='construct'><table summary="<BooleanFilter>'s children">
+<thead>
+<tr><th class='title' colspan='2'><BooleanFilter>'s children</th></tr>
+<tr><th colspan='2' height='1' class='ruler'></th></tr>
+<tr><th class='subtitle'>Name</th><th class='subtitle'>Cardinality</th></tr>
+<tr><th colspan='2' height='1' class='ruler'></th></tr>
+</thead>
+<tbody><tr><td><a href='#Clause'>Clause</a></td><td>At least one</td></tr>
+</tbody></table></td></tr></table></blockquote>
+<span class='inTextTitle'>Element's model:</span><p class='model'>(<a href='#Clause'>Clause</a>)+</p></body></html>