Modified:
websites/staging/lucy/trunk/content/docs/test/Lucy/Search/RequiredOptionalQuery.html
==============================================================================
---
websites/staging/lucy/trunk/content/docs/test/Lucy/Search/RequiredOptionalQuery.html
(original)
+++
websites/staging/lucy/trunk/content/docs/test/Lucy/Search/RequiredOptionalQuery.html
Fri Feb 26 12:52:42 2016
@@ -71,17 +71,17 @@
<div>
<a name='___top' class='dummyTopAnchor' ></a>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="NAME"
->NAME</a></h1>
+>NAME</a></h2>
<p>Lucy::Search::RequiredOptionalQuery - Join results for two Queries,
one required,
one optional.</p>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="SYNOPSIS"
->SYNOPSIS</a></h1>
+>SYNOPSIS</a></h2>
<pre> my $foo_and_maybe_bar = Lucy::Search::RequiredOptionalQuery->new(
required_query => $foo_query,
@@ -90,62 +90,93 @@ name="SYNOPSIS"
my $hits = $searcher->hits( query => $foo_and_maybe_bar );
...</pre>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="DESCRIPTION"
->DESCRIPTION</a></h1>
+>DESCRIPTION</a></h2>
<p>RequiredOptionalQuery joins the result sets of one Query which MUST match,
and one Query which SHOULD match. When only the required Query matches, its
score is passed along; when both match, the scores are summed.</p>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="CONSTRUCTORS"
->CONSTRUCTORS</a></h1>
+>CONSTRUCTORS</a></h2>
-<h2><a class='u' href='#___top' title='click to go to top of document'
-name="new(_[labeled_params]_)"
->new( <i>[labeled params]</i> )</a></h2>
+<h3><a class='u'
+name="new"
+>new</a></h3>
<pre> my $reqopt_query = Lucy::Search::RequiredOptionalQuery->new(
required_query => $foo_query, # required
optional_query => $bar_query, # required
);</pre>
+<p>Create a new RequiredOptionalQuery.</p>
+
<ul>
<li><b>required_query</b> - Query must must match.</li>
<li><b>optional_query</b> - Query which should match.</li>
</ul>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="METHODS"
->METHODS</a></h1>
+>METHODS</a></h2>
+
+<h3><a class='u'
+name="get_required_query"
+>get_required_query</a></h3>
-<h2><a class='u' href='#___top' title='click to go to top of document'
-name="get_required_query()"
->get_required_query()</a></h2>
+<pre> my $retval = $required_optional_query->get_required_query();</pre>
<p>Getter for the required Query.</p>
-<h2><a class='u' href='#___top' title='click to go to top of document'
-name="set_required_query(required_query)"
->set_required_query(required_query)</a></h2>
+<h3><a class='u'
+name="set_required_query"
+>set_required_query</a></h3>
+
+<pre>
$required_optional_query->set_required_query($required_query);</pre>
<p>Setter for the required Query.</p>
-<h2><a class='u' href='#___top' title='click to go to top of document'
-name="get_optional_query()"
->get_optional_query()</a></h2>
+<h3><a class='u'
+name="get_optional_query"
+>get_optional_query</a></h3>
+
+<pre> my $retval = $required_optional_query->get_optional_query();</pre>
<p>Getter for the optional Query.</p>
-<h2><a class='u' href='#___top' title='click to go to top of document'
-name="set_optional_query(optional_query)"
->set_optional_query(optional_query)</a></h2>
+<h3><a class='u'
+name="set_optional_query"
+>set_optional_query</a></h3>
+
+<pre>
$required_optional_query->set_optional_query($optional_query);</pre>
<p>Setter for the optional Query.</p>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h3><a class='u'
+name="make_compiler"
+>make_compiler</a></h3>
+
+<pre> my $retval = $required_optional_query->make_compiler(
+ searcher => $searcher # required
+ boost => $boost # required
+ subordinate => $subordinate # default: false
+ );</pre>
+
+<p>Abstract factory method returning a Compiler derived from this Query.</p>
+
+<ul>
+<li><b>searcher</b> - A Searcher.</li>
+
+<li><b>boost</b> - A scoring multiplier.</li>
+
+<li><b>subordinate</b> - Indicates whether the Query is a subquery (as opposed
to a top-level query). If false, the implementation must invoke <a
href="../../Lucy/Search/Compiler.html#normalize" class="podlinkpod"
+>normalize()</a> on the newly minted Compiler object before returning it.</li>
+</ul>
+
+<h2><a class='u'
name="INHERITANCE"
->INHERITANCE</a></h1>
+>INHERITANCE</a></h2>
<p>Lucy::Search::RequiredOptionalQuery isa <a
href="../../Lucy/Search/PolyQuery.html" class="podlinkpod"
>Lucy::Search::PolyQuery</a> isa <a href="../../Lucy/Search/Query.html"
>class="podlinkpod"
Modified:
websites/staging/lucy/trunk/content/docs/test/Lucy/Search/Searcher.html
==============================================================================
--- websites/staging/lucy/trunk/content/docs/test/Lucy/Search/Searcher.html
(original)
+++ websites/staging/lucy/trunk/content/docs/test/Lucy/Search/Searcher.html Fri
Feb 26 12:52:42 2016
@@ -71,33 +71,33 @@
<div>
<a name='___top' class='dummyTopAnchor' ></a>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="NAME"
->NAME</a></h1>
+>NAME</a></h2>
<p>Lucy::Search::Searcher - Base class for searching collections of
documents.</p>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="SYNOPSIS"
->SYNOPSIS</a></h1>
+>SYNOPSIS</a></h2>
<pre> # Abstract base class.</pre>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="DESCRIPTION"
->DESCRIPTION</a></h1>
+>DESCRIPTION</a></h2>
<p>Abstract base class for objects which search. Core subclasses include <a
href="../../Lucy/Search/IndexSearcher.html" class="podlinkpod"
->Lucy::Search::IndexSearcher</a> and <a
href="../../Lucy/Search/PolySearcher.html" class="podlinkpod"
->Lucy::Search::PolySearcher</a>.</p>
+>IndexSearcher</a> and <a href="../../Lucy/Search/PolySearcher.html"
class="podlinkpod"
+>PolySearcher</a>.</p>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="CONSTRUCTORS"
->CONSTRUCTORS</a></h1>
+>CONSTRUCTORS</a></h2>
-<h2><a class='u' href='#___top' title='click to go to top of document'
-name="new(_[labeled_params]_)"
->new( <i>[labeled params]</i> )</a></h2>
+<h3><a class='u'
+name="new"
+>new</a></h3>
<pre> package MySearcher;
use base qw( Lucy::Search::Searcher );
@@ -113,32 +113,26 @@ name="new(_[labeled_params]_)"
<li><b>schema</b> - A Schema.</li>
</ul>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="ABSTRACT_METHODS"
->ABSTRACT METHODS</a></h1>
+>ABSTRACT METHODS</a></h2>
-<h2><a class='u' href='#___top' title='click to go to top of document'
-name="collect(_[labeled_params]_)"
->collect( <i>[labeled params]</i> )</a></h2>
+<h3><a class='u'
+name="doc_max"
+>doc_max</a></h3>
-<p>Iterate over hits, feeding them into a <a
href="../../Lucy/Search/Collector.html" class="podlinkpod"
->Collector</a>.</p>
-
-<ul>
-<li><b>query</b> - A Query.</li>
-
-<li><b>collector</b> - A Collector.</li>
-</ul>
-
-<h2><a class='u' href='#___top' title='click to go to top of document'
-name="doc_max()"
->doc_max()</a></h2>
+<pre> my $retval = $searcher->doc_max();</pre>
<p>Return the maximum number of docs in the collection represented by the
Searcher, which is also the highest possible internal doc id. Documents which
have been marked as deleted but not yet purged are included in this count.</p>
-<h2><a class='u' href='#___top' title='click to go to top of document'
-name="doc_freq(_[labeled_params]_)"
->doc_freq( <i>[labeled params]</i> )</a></h2>
+<h3><a class='u'
+name="doc_freq"
+>doc_freq</a></h3>
+
+<pre> my $retval = $searcher->doc_freq(
+ field => $field # required
+ term => $term # required
+ );</pre>
<p>Return the number of documents which contain the term in the given
field.</p>
@@ -148,9 +142,29 @@ name="doc_freq(_[labeled_params]_)"
<li><b>term</b> - The term to look up.</li>
</ul>
-<h2><a class='u' href='#___top' title='click to go to top of document'
-name="fetch_doc(doc_id)"
->fetch_doc(doc_id)</a></h2>
+<h3><a class='u'
+name="collect"
+>collect</a></h3>
+
+<pre> $searcher->collect(
+ query => $query # required
+ collector => $collector # required
+ );</pre>
+
+<p>Iterate over hits, feeding them into a <a
href="../../Lucy/Search/Collector.html" class="podlinkpod"
+>Collector</a>.</p>
+
+<ul>
+<li><b>query</b> - A Query.</li>
+
+<li><b>collector</b> - A Collector.</li>
+</ul>
+
+<h3><a class='u'
+name="fetch_doc"
+>fetch_doc</a></h3>
+
+<pre> my $retval = $searcher->fetch_doc($doc_id);</pre>
<p>Retrieve a document. Throws an error if the doc id is out of range.</p>
@@ -158,42 +172,54 @@ name="fetch_doc(doc_id)"
<li><b>doc_id</b> - A document id.</li>
</ul>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="METHODS"
->METHODS</a></h1>
+>METHODS</a></h2>
-<h2><a class='u' href='#___top' title='click to go to top of document'
-name="hits(_[labeled_params]_)"
->hits( <i>[labeled params]</i> )</a></h2>
+<h3><a class='u'
+name="glean_query"
+>glean_query</a></h3>
+
+<pre> my $retval = $searcher->glean_query($query);
+ my $retval = $searcher->glean_query(); # default: undef</pre>
+
+<p>If the supplied object is a Query, return it; if it’s a query string,
create a QueryParser and parse it to produce a query against all indexed
fields.</p>
+
+<h3><a class='u'
+name="hits"
+>hits</a></h3>
+
+<pre> my $retval = $searcher->hits(
+ query => $query # required
+ offset => $offset # default: 0
+ num_wanted => $num_wanted # default: 10
+ sort_spec => $sort_spec # default: undef
+ );</pre>
<p>Return a Hits object containing the top results.</p>
<ul>
<li><b>query</b> - Either a Query object or a query string.</li>
-<li><b>offset</b> - The number of most-relevant hits to discard, typically
used when "paging" through hits N at a time. Setting
<code>offset</code> to 20 and <code>num_wanted</code> to 10 retrieves hits
21-30, assuming that 30 hits can be found.</li>
+<li><b>offset</b> - The number of most-relevant hits to discard, typically
used when “paging” through hits N at a time. Setting
<code>offset</code> to 20 and <code>num_wanted</code> to 10 retrieves hits
21-30, assuming that 30 hits can be found.</li>
<li><b>num_wanted</b> - The number of hits you would like to see after
<code>offset</code> is taken into account.</li>
<li><b>sort_spec</b> - A <a href="../../Lucy/Search/SortSpec.html"
class="podlinkpod"
->Lucy::Search::SortSpec</a>, which will affect how results are ranked and
returned.</li>
+>SortSpec</a>, which will affect how results are ranked and returned.</li>
</ul>
-<h2><a class='u' href='#___top' title='click to go to top of document'
-name="glean_query(query)"
->glean_query(query)</a></h2>
-
-<p>If the supplied object is a Query, return it; if it's a query string,
create a QueryParser and parse it to produce a query against all indexed
fields.</p>
+<h3><a class='u'
+name="get_schema"
+>get_schema</a></h3>
-<h2><a class='u' href='#___top' title='click to go to top of document'
-name="get_schema()"
->get_schema()</a></h2>
+<pre> my $retval = $searcher->get_schema();</pre>
-<p>Accessor for the object's <code>schema</code> member.</p>
+<p>Accessor for the object’s <code>schema</code> member.</p>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="INHERITANCE"
->INHERITANCE</a></h1>
+>INHERITANCE</a></h2>
<p>Lucy::Search::Searcher isa Clownfish::Obj.</p>
Modified:
websites/staging/lucy/trunk/content/docs/test/Lucy/Search/SortRule.html
==============================================================================
--- websites/staging/lucy/trunk/content/docs/test/Lucy/Search/SortRule.html
(original)
+++ websites/staging/lucy/trunk/content/docs/test/Lucy/Search/SortRule.html Fri
Feb 26 12:52:42 2016
@@ -71,15 +71,15 @@
<div>
<a name='___top' class='dummyTopAnchor' ></a>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="NAME"
->NAME</a></h1>
+>NAME</a></h2>
<p>Lucy::Search::SortRule - Element of a SortSpec.</p>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="SYNOPSIS"
->SYNOPSIS</a></h1>
+>SYNOPSIS</a></h2>
<pre> my $sort_spec = Lucy::Search::SortSpec->new(
rules => [
@@ -88,20 +88,20 @@ name="SYNOPSIS"
],
);</pre>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="DESCRIPTION"
->DESCRIPTION</a></h1>
+>DESCRIPTION</a></h2>
<p>SortRules are the building blocks used to assemble <a
href="../../Lucy/Search/SortSpec.html" class="podlinkpod"
->SortSpecs</a>; each SortRule defines a single level of sorting. For example,
sorting first by "category" then by score requires a SortSpec with two
SortRule elements.</p>
+>SortSpecs</a>; each SortRule defines a single level of sorting. For example,
sorting first by “category” then by score requires a SortSpec with
two SortRule elements.</p>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="CONSTRUCTORS"
->CONSTRUCTORS</a></h1>
+>CONSTRUCTORS</a></h2>
-<h2><a class='u' href='#___top' title='click to go to top of document'
-name="new(_[labeled_params]_)"
->new( <i>[labeled params]</i> )</a></h2>
+<h3><a class='u'
+name="new"
+>new</a></h3>
<pre> my $by_title = Lucy::Search::SortRule->new( field =>
'title' );
my $by_score = Lucy::Search::SortRule->new( type =>
'score' );
@@ -111,6 +111,8 @@ name="new(_[labeled_params]_)"
reverse => 1,
);</pre>
+<p>Create a new SortRule.</p>
+
<ul>
<li><b>type</b> - Indicate whether to sort by score, field, etc. (The default
is to sort by a field.)</li>
@@ -119,25 +121,37 @@ name="new(_[labeled_params]_)"
<li><b>reverse</b> - If true, reverse the order of the sort for this rule.</li>
</ul>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="METHODS"
->METHODS</a></h1>
+>METHODS</a></h2>
+
+<h3><a class='u'
+name="get_field"
+>get_field</a></h3>
+
+<pre> my $retval = $sort_rule->get_field();</pre>
+
+<p>Accessor for “field” member.</p>
+
+<h3><a class='u'
+name="get_type"
+>get_type</a></h3>
+
+<pre> my $retval = $sort_rule->get_type();</pre>
-<h2><a class='u' href='#___top' title='click to go to top of document'
-name="get_field()"
->get_field()</a></h2>
+<p>Accessor for “type” member.</p>
-<p>Accessor for "field" member.</p>
+<h3><a class='u'
+name="get_reverse"
+>get_reverse</a></h3>
-<h2><a class='u' href='#___top' title='click to go to top of document'
-name="get_reverse()"
->get_reverse()</a></h2>
+<pre> my $retval = $sort_rule->get_reverse();</pre>
-<p>Accessor for "reverse" member.</p>
+<p>Accessor for “reverse” member.</p>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="INHERITANCE"
->INHERITANCE</a></h1>
+>INHERITANCE</a></h2>
<p>Lucy::Search::SortRule isa Clownfish::Obj.</p>
Modified:
websites/staging/lucy/trunk/content/docs/test/Lucy/Search/SortSpec.html
==============================================================================
--- websites/staging/lucy/trunk/content/docs/test/Lucy/Search/SortSpec.html
(original)
+++ websites/staging/lucy/trunk/content/docs/test/Lucy/Search/SortSpec.html Fri
Feb 26 12:52:42 2016
@@ -71,15 +71,15 @@
<div>
<a name='___top' class='dummyTopAnchor' ></a>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="NAME"
->NAME</a></h1>
+>NAME</a></h2>
<p>Lucy::Search::SortSpec - Specify a custom sort order for search results.</p>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="SYNOPSIS"
->SYNOPSIS</a></h1>
+>SYNOPSIS</a></h2>
<pre> my $sort_spec = Lucy::Search::SortSpec->new(
rules => [
@@ -92,9 +92,9 @@ name="SYNOPSIS"
sort_spec => $sort_spec,
);</pre>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="DESCRIPTION"
->DESCRIPTION</a></h1>
+>DESCRIPTION</a></h2>
<p>By default, searches return results in order of relevance; SortSpec allows
you to indicate an alternate order via an array of <a
href="../../Lucy/Search/SortRule.html" class="podlinkpod"
>SortRules</a>.</p>
@@ -103,23 +103,25 @@ name="DESCRIPTION"
<p>For a stable sort (important when paging through results), add a
sort-by-doc rule as the last SortRule.</p>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="CONSTRUCTORS"
->CONSTRUCTORS</a></h1>
+>CONSTRUCTORS</a></h2>
-<h2><a class='u' href='#___top' title='click to go to top of document'
-name="new(_[labeled_params]_)"
->new( <i>[labeled params]</i> )</a></h2>
+<h3><a class='u'
+name="new"
+>new</a></h3>
<pre> my $sort_spec = Lucy::Search::SortSpec->new( rules => \@rules
);</pre>
+<p>Create a new SortSpec.</p>
+
<ul>
<li><b>rules</b> - An array of SortRules.</li>
</ul>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="INHERITANCE"
->INHERITANCE</a></h1>
+>INHERITANCE</a></h2>
<p>Lucy::Search::SortSpec isa Clownfish::Obj.</p>
Modified: websites/staging/lucy/trunk/content/docs/test/Lucy/Search/Span.html
==============================================================================
--- websites/staging/lucy/trunk/content/docs/test/Lucy/Search/Span.html
(original)
+++ websites/staging/lucy/trunk/content/docs/test/Lucy/Search/Span.html Fri Feb
26 12:52:42 2016
@@ -71,17 +71,17 @@
<div>
<a name='___top' class='dummyTopAnchor' ></a>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="NAME"
->NAME</a></h1>
+>NAME</a></h2>
<p>Lucy::Search::Span - An offset,
a length,
and a weight.</p>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="SYNOPSIS"
->SYNOPSIS</a></h1>
+>SYNOPSIS</a></h2>
<pre> my $combined_length = $upper_span->get_length
+ ( $upper_span->get_offset - $lower_span->get_offset );
@@ -91,21 +91,21 @@ name="SYNOPSIS"
);
...</pre>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="DESCRIPTION"
->DESCRIPTION</a></h1>
+>DESCRIPTION</a></h2>
-<p>Span objects store information about a span across an array of...
something. The unit is context-dependent.</p>
+<p>Span objects store information about a span across an array of…
something. The unit is context-dependent.</p>
-<p>Text is one possibility, in which case offset and length might be measured
in Unicode code points. However, the Span could also refer to a span within an
array of tokens, for example -- in which case the start and offset might be
measured in token positions.</p>
+<p>Text is one possibility, in which case offset and length might be measured
in Unicode code points. However, the Span could also refer to a span within an
array of tokens, for example – in which case the start and offset might
be measured in token positions.</p>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="CONSTRUCTORS"
->CONSTRUCTORS</a></h1>
+>CONSTRUCTORS</a></h2>
-<h2><a class='u' href='#___top' title='click to go to top of document'
-name="new(_[labeled_params]_)"
->new( <i>[labeled params]</i> )</a></h2>
+<h3><a class='u'
+name="new"
+>new</a></h3>
<pre> my $span = Lucy::Search::Span->new(
offset => 75, # required
@@ -113,6 +113,8 @@ name="new(_[labeled_params]_)"
weight => 1.0, # default 0.0
);</pre>
+<p>Create a new Span.</p>
+
<ul>
<li><b>offset</b> - Integer offset, unit is context-dependent.</li>
@@ -121,49 +123,75 @@ name="new(_[labeled_params]_)"
<li><b>weight</b> - A floating point weight.</li>
</ul>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="METHODS"
->METHODS</a></h1>
+>METHODS</a></h2>
+
+<h3><a class='u'
+name="get_offset"
+>get_offset</a></h3>
+
+<pre> my $retval = $span->get_offset();</pre>
+
+<p>Accessor for <code>offset</code> attribute.</p>
-<h2><a class='u' href='#___top' title='click to go to top of document'
-name="set_offset(offset)"
->set_offset(offset)</a></h2>
+<h3><a class='u'
+name="set_offset"
+>set_offset</a></h3>
+
+<pre> $span->set_offset($offset);</pre>
<p>Setter for <code>offset</code> attribute.</p>
-<h2><a class='u' href='#___top' title='click to go to top of document'
-name="get_offset()"
->get_offset()</a></h2>
+<h3><a class='u'
+name="get_length"
+>get_length</a></h3>
-<p>Accessor for <code>offset</code> attribute.</p>
+<pre> my $retval = $span->get_length();</pre>
+
+<p>Accessor for <code>length</code> attribute.</p>
+
+<h3><a class='u'
+name="set_length"
+>set_length</a></h3>
-<h2><a class='u' href='#___top' title='click to go to top of document'
-name="set_length(length)"
->set_length(length)</a></h2>
+<pre> $span->set_length($length);</pre>
<p>Setter for <code>length</code> attribute.</p>
-<h2><a class='u' href='#___top' title='click to go to top of document'
-name="get_length()"
->get_length()</a></h2>
+<h3><a class='u'
+name="get_weight"
+>get_weight</a></h3>
-<p>Accessor for <code>length</code> attribute.</p>
+<pre> my $retval = $span->get_weight();</pre>
+
+<p>Accessor for <code>weight</code> attribute.</p>
-<h2><a class='u' href='#___top' title='click to go to top of document'
-name="set_weight(weight)"
->set_weight(weight)</a></h2>
+<h3><a class='u'
+name="set_weight"
+>set_weight</a></h3>
+
+<pre> $span->set_weight($weight);</pre>
<p>Setter for <code>weight</code> attribute.</p>
-<h2><a class='u' href='#___top' title='click to go to top of document'
-name="get_weight()"
->get_weight()</a></h2>
+<h3><a class='u'
+name="compare_to"
+>compare_to</a></h3>
-<p>Accessor for <code>weight</code> attribute.</p>
+<pre> my $retval = $span->compare_to($other);</pre>
+
+<p>Indicate whether one object is less than, equal to, or greater than
another.</p>
+
+<ul>
+<li><b>other</b> - Another Obj.</li>
+</ul>
+
+<p>Returns: 0 if the objects are equal, a negative number if <code>self</code>
is less than <code>other</code>, and a positive number if <code>self</code> is
greater than <code>other</code>.</p>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="INHERITANCE"
->INHERITANCE</a></h1>
+>INHERITANCE</a></h2>
<p>Lucy::Search::Span isa Clownfish::Obj.</p>
Modified:
websites/staging/lucy/trunk/content/docs/test/Lucy/Search/TermQuery.html
==============================================================================
--- websites/staging/lucy/trunk/content/docs/test/Lucy/Search/TermQuery.html
(original)
+++ websites/staging/lucy/trunk/content/docs/test/Lucy/Search/TermQuery.html
Fri Feb 26 12:52:42 2016
@@ -71,15 +71,15 @@
<div>
<a name='___top' class='dummyTopAnchor' ></a>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="NAME"
->NAME</a></h1>
+>NAME</a></h2>
<p>Lucy::Search::TermQuery - Query which matches individual terms.</p>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="SYNOPSIS"
->SYNOPSIS</a></h1>
+>SYNOPSIS</a></h2>
<pre> my $term_query = Lucy::Search::TermQuery->new(
field => 'content',
@@ -87,51 +87,78 @@ name="SYNOPSIS"
);
my $hits = $searcher->hits( query => $term_query );</pre>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="DESCRIPTION"
->DESCRIPTION</a></h1>
+>DESCRIPTION</a></h2>
<p>TermQuery is a subclass of <a href="../../Lucy/Search/Query.html"
class="podlinkpod"
->Lucy::Search::Query</a> for matching individual terms in a specific field.</p>
+>Query</a> for matching individual terms in a specific field.</p>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="CONSTRUCTORS"
->CONSTRUCTORS</a></h1>
+>CONSTRUCTORS</a></h2>
-<h2><a class='u' href='#___top' title='click to go to top of document'
-name="new(_[labeled_params]_)"
->new( <i>[labeled params]</i> )</a></h2>
+<h3><a class='u'
+name="new"
+>new</a></h3>
<pre> my $term_query = Lucy::Search::TermQuery->new(
field => 'content', # required
term => 'foo', # required
);</pre>
+<p>Create a new TermQuery.</p>
+
<ul>
<li><b>field</b> - Field name.</li>
<li><b>term</b> - Term text.</li>
</ul>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="METHODS"
->METHODS</a></h1>
+>METHODS</a></h2>
+
+<h3><a class='u'
+name="get_field"
+>get_field</a></h3>
+
+<pre> my $retval = $term_query->get_field();</pre>
+
+<p>Accessor for object’s <code>field</code> member.</p>
+
+<h3><a class='u'
+name="get_term"
+>get_term</a></h3>
+
+<pre> my $retval = $term_query->get_term();</pre>
-<h2><a class='u' href='#___top' title='click to go to top of document'
-name="get_field()"
->get_field()</a></h2>
+<p>Accessor for object’s <code>term</code> member.</p>
-<p>Accessor for object's <code>field</code> member.</p>
+<h3><a class='u'
+name="make_compiler"
+>make_compiler</a></h3>
-<h2><a class='u' href='#___top' title='click to go to top of document'
-name="get_term()"
->get_term()</a></h2>
+<pre> my $retval = $term_query->make_compiler(
+ searcher => $searcher # required
+ boost => $boost # required
+ subordinate => $subordinate # default: false
+ );</pre>
+
+<p>Abstract factory method returning a Compiler derived from this Query.</p>
+
+<ul>
+<li><b>searcher</b> - A Searcher.</li>
+
+<li><b>boost</b> - A scoring multiplier.</li>
-<p>Accessor for object's <code>term</code> member.</p>
+<li><b>subordinate</b> - Indicates whether the Query is a subquery (as opposed
to a top-level query). If false, the implementation must invoke <a
href="../../Lucy/Search/Compiler.html#normalize" class="podlinkpod"
+>normalize()</a> on the newly minted Compiler object before returning it.</li>
+</ul>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="INHERITANCE"
->INHERITANCE</a></h1>
+>INHERITANCE</a></h2>
<p>Lucy::Search::TermQuery isa <a href="../../Lucy/Search/Query.html"
class="podlinkpod"
>Lucy::Search::Query</a> isa Clownfish::Obj.</p>
Modified: websites/staging/lucy/trunk/content/docs/test/Lucy/Simple.html
==============================================================================
--- websites/staging/lucy/trunk/content/docs/test/Lucy/Simple.html (original)
+++ websites/staging/lucy/trunk/content/docs/test/Lucy/Simple.html Fri Feb 26
12:52:42 2016
@@ -71,15 +71,15 @@
<div>
<a name='___top' class='dummyTopAnchor' ></a>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="NAME"
->NAME</a></h1>
+>NAME</a></h2>
<p>Lucy::Simple - Basic search engine.</p>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="SYNOPSIS"
->SYNOPSIS</a></h1>
+>SYNOPSIS</a></h2>
<p>First,
build an index of your documents.</p>
@@ -98,7 +98,7 @@ build an index of your documents.</p>
<p>Later, search the index.</p>
-<pre> my $total_hits = $index->search(
+<pre> my $total_hits = $index->search(
query => $query_string,
offset => 0,
num_wanted => 10,
@@ -109,27 +109,26 @@ build an index of your documents.</p>
print "$hit->{title}\n",
}</pre>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="DESCRIPTION"
->DESCRIPTION</a></h1>
+>DESCRIPTION</a></h2>
-<p>Lucy::Simple is a stripped-down interface for the <a href="../Lucy.html"
class="podlinkpod"
->Apache Lucy</a> search engine library.</p>
+<p>Lucy::Simple is a stripped-down interface for the Apache Lucy search engine
library.</p>
-<h1><a class='u' href='#___top' title='click to go to top of document'
-name="METHODS"
->METHODS</a></h1>
+<h2><a class='u'
+name="CONSTRUCTORS"
+>CONSTRUCTORS</a></h2>
-<h2><a class='u' href='#___top' title='click to go to top of document'
+<h3><a class='u'
name="new"
->new</a></h2>
+>new</a></h3>
<pre> my $lucy = Lucy::Simple->new(
path => '/path/to/index/',
language => 'en',
);</pre>
-<p>Create a Lucy::Simple object, which can be used for both indexing and
searching. Two hash-style parameters are required.</p>
+<p>Create a Lucy::Simple object, which can be used for both indexing and
searching. Both parameters <code>path</code> and <code>language</code> are
required.</p>
<ul>
<li><b>path</b> - Where the index directory should be located. If no index is
found at the specified location, one will be created.</li>
@@ -154,9 +153,13 @@ name="new"
</li>
</ul>
-<h2><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
+name="METHODS"
+>METHODS</a></h2>
+
+<h3><a class='u'
name="add_doc"
->add_doc</a></h2>
+>add_doc</a></h3>
<pre> $lucy->add_doc({
location => $url,
@@ -166,14 +169,14 @@ name="add_doc"
<p>Add a document to the index. The document must be supplied as a hashref,
with field names as keys and content as values.</p>
-<h2><a class='u' href='#___top' title='click to go to top of document'
+<h3><a class='u'
name="search"
->search</a></h2>
+>search</a></h3>
-<pre> my $total_hits = $lucy->search(
- query => $query_string, # required
- offset => 40, # default 0
- num_wanted => 20, # default 10
+<pre> my $retval = $simple->search(
+ query => $query # required
+ offset => $offset # default: 0
+ num_wanted => $num_wanted # default: 10
);</pre>
<p>Search the index. Returns the total number of documents which match the
query. (This number is unlikely to match <code>num_wanted</code>.)</p>
@@ -181,16 +184,24 @@ name="search"
<ul>
<li><b>query</b> - A search query string.</li>
-<li><b>offset</b> - The number of most-relevant hits to discard, typically
used when "paging" through hits N at a time. Setting offset to 20 and
num_wanted to 10 retrieves hits 21-30, assuming that 30 hits can be found.</li>
+<li><b>offset</b> - The number of most-relevant hits to discard, typically
used when “paging” through hits N at a time. Setting offset to 20
and num_wanted to 10 retrieves hits 21-30, assuming that 30 hits can be
found.</li>
<li><b>num_wanted</b> - The number of hits you would like to see after
<code>offset</code> is taken into account.</li>
</ul>
-<h1><a class='u' href='#___top' title='click to go to top of document'
-name="BUGS"
->BUGS</a></h1>
+<h3><a class='u'
+name="next"
+>next</a></h3>
+
+<pre> my $retval = $simple->next();</pre>
+
+<p>Return the next hit, or undef when the iterator is exhausted.</p>
+
+<h2><a class='u'
+name="INHERITANCE"
+>INHERITANCE</a></h2>
-<p>Not thread-safe.</p>
+<p>Lucy::Simple isa Clownfish::Obj.</p>
</div>
Modified: websites/staging/lucy/trunk/content/docs/test/Lucy/Store/FSFolder.html
==============================================================================
--- websites/staging/lucy/trunk/content/docs/test/Lucy/Store/FSFolder.html
(original)
+++ websites/staging/lucy/trunk/content/docs/test/Lucy/Store/FSFolder.html Fri
Feb 26 12:52:42 2016
@@ -71,46 +71,48 @@
<div>
<a name='___top' class='dummyTopAnchor' ></a>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="NAME"
->NAME</a></h1>
+>NAME</a></h2>
<p>Lucy::Store::FSFolder - File System implementation of Folder.</p>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="SYNOPSIS"
->SYNOPSIS</a></h1>
+>SYNOPSIS</a></h2>
<pre> my $folder = Lucy::Store::FSFolder->new(
path => '/path/to/folder',
);</pre>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="DESCRIPTION"
->DESCRIPTION</a></h1>
+>DESCRIPTION</a></h2>
<p>Implementation of <a href="../../Lucy/Store/Folder.html" class="podlinkpod"
->Lucy::Store::Folder</a> using a single file system directory and multiple
files.</p>
+>Folder</a> using a single file system directory and multiple files.</p>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="CONSTRUCTORS"
->CONSTRUCTORS</a></h1>
+>CONSTRUCTORS</a></h2>
-<h2><a class='u' href='#___top' title='click to go to top of document'
-name="new(_[labeled_params]_)"
->new( <i>[labeled params]</i> )</a></h2>
+<h3><a class='u'
+name="new"
+>new</a></h3>
<pre> my $folder = Lucy::Store::FSFolder->new(
path => '/path/to/folder',
);</pre>
+<p>Create a new Folder.</p>
+
<ul>
-<li><b>path</b> - Location of the index. If the specified directory does not
exist already, it will NOT be created, in order to prevent misconfigured read
applications from spawning bogus files -- so it may be necessary to create the
directory yourself.</li>
+<li><b>path</b> - Location of the index. If the specified directory does not
exist already, it will NOT be created, in order to prevent misconfigured read
applications from spawning bogus files – so it may be necessary to create
the directory yourself.</li>
</ul>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="INHERITANCE"
->INHERITANCE</a></h1>
+>INHERITANCE</a></h2>
<p>Lucy::Store::FSFolder isa <a href="../../Lucy/Store/Folder.html"
class="podlinkpod"
>Lucy::Store::Folder</a> isa Clownfish::Obj.</p>
Modified: websites/staging/lucy/trunk/content/docs/test/Lucy/Store/Folder.html
==============================================================================
--- websites/staging/lucy/trunk/content/docs/test/Lucy/Store/Folder.html
(original)
+++ websites/staging/lucy/trunk/content/docs/test/Lucy/Store/Folder.html Fri
Feb 26 12:52:42 2016
@@ -71,30 +71,30 @@
<div>
<a name='___top' class='dummyTopAnchor' ></a>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="NAME"
->NAME</a></h1>
+>NAME</a></h2>
<p>Lucy::Store::Folder - Abstract class representing a directory.</p>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="SYNOPSIS"
->SYNOPSIS</a></h1>
+>SYNOPSIS</a></h2>
<pre> # Abstract base class.</pre>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="DESCRIPTION"
->DESCRIPTION</a></h1>
+>DESCRIPTION</a></h2>
-<p>A "file" within a Folder might be a real file on disk -- or it
might be a RAM buffer. Similarly, delete() might delete a file from the file
system, or a key-value pair from a hash, or something else.</p>
+<p>A “file” within a Folder might be a real file on disk –
or it might be a RAM buffer. Similarly, Delete() might delete a file from the
file system, or a key-value pair from a hash, or something else.</p>
<p>The archetypal implementation of Folder, <a
href="../../Lucy/Store/FSFolder.html" class="podlinkpod"
>FSFolder</a>, represents a directory on the file system holding a collection
>of files.</p>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="INHERITANCE"
->INHERITANCE</a></h1>
+>INHERITANCE</a></h2>
<p>Lucy::Store::Folder isa Clownfish::Obj.</p>
Modified: websites/staging/lucy/trunk/content/docs/test/Lucy/Store/Lock.html
==============================================================================
--- websites/staging/lucy/trunk/content/docs/test/Lucy/Store/Lock.html
(original)
+++ websites/staging/lucy/trunk/content/docs/test/Lucy/Store/Lock.html Fri Feb
26 12:52:42 2016
@@ -71,15 +71,15 @@
<div>
<a name='___top' class='dummyTopAnchor' ></a>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="NAME"
->NAME</a></h1>
+>NAME</a></h2>
<p>Lucy::Store::Lock - Abstract class representing an interprocess mutex
lock.</p>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="SYNOPSIS"
->SYNOPSIS</a></h1>
+>SYNOPSIS</a></h2>
<pre> my $lock = $lock_factory->make_lock(
name => 'write',
@@ -89,21 +89,21 @@ name="SYNOPSIS"
do_stuff();
$lock->release;</pre>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="DESCRIPTION"
->DESCRIPTION</a></h1>
+>DESCRIPTION</a></h2>
<p>The Lock class produces an interprocess mutex lock. The default subclass
uses dot-lock files, but alternative implementations are possible.</p>
-<p>Each lock must have a name which is unique per resource to be locked. Each
lock also has a "host" id which should be unique per machine; it is
used to help clear away stale locks.</p>
+<p>Each lock must have a name which is unique per resource to be locked. Each
lock also has a “host” id which should be unique per machine; it is
used to help clear away stale locks.</p>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="CONSTRUCTORS"
->CONSTRUCTORS</a></h1>
+>CONSTRUCTORS</a></h2>
-<h2><a class='u' href='#___top' title='click to go to top of document'
-name="new(_[labeled_params]_)"
->new( <i>[labeled params]</i> )</a></h2>
+<h3><a class='u'
+name="new"
+>new</a></h3>
<pre> my $lock = Lucy::Store::Lock->new(
name => 'commit', # required
@@ -122,60 +122,87 @@ name="new(_[labeled_params]_)"
<li><b>host</b> - A unique per-machine identifier.</li>
-<li><b>timeout</b> - Time in milliseconds to keep retrying before abandoning
the attempt to obtain() a lock.</li>
+<li><b>timeout</b> - Time in milliseconds to keep retrying before abandoning
the attempt to <a href="#obtain" class="podlinkpod"
+>obtain()</a> a lock.</li>
<li><b>interval</b> - Time in milliseconds between retries.</li>
</ul>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="ABSTRACT_METHODS"
->ABSTRACT METHODS</a></h1>
+>ABSTRACT METHODS</a></h2>
-<h2><a class='u' href='#___top' title='click to go to top of document'
-name="request()"
->request()</a></h2>
+<h3><a class='u'
+name="shared"
+>shared</a></h3>
-<p>Make one attempt to acquire the lock.</p>
+<pre> my $retval = $lock->shared();</pre>
+
+<p>Returns true if the Lock is shared, false if the Lock is exclusive.</p>
+
+<h3><a class='u'
+name="request"
+>request</a></h3>
+
+<pre> my $retval = $lock->request();</pre>
-<p>The semantics of request() differ depending on whether shared() returns
true. If the Lock is shared(), then request() should not fail if another lock
is held against the resource identified by <code>name</code> (though it might
fail for other reasons). If it is not shared() -- i.e. it's an exclusive
(write) lock -- then other locks should cause request() to fail.</p>
+<p>Make one attempt to acquire the lock.</p>
-<p>Returns: true on success, false on failure (sets Clownfish->error).</p>
+<p>The semantics of <a href="#request" class="podlinkpod"
+>request()</a> differ depending on whether <a href="#shared" class="podlinkpod"
+>shared()</a> returns true. If the Lock is <a href="#shared" class="podlinkpod"
+>shared()</a>, then <a href="#request" class="podlinkpod"
+>request()</a> should not fail if another lock is held against the resource
identified by <code>name</code> (though it might fail for other reasons). If it
is not <a href="#shared" class="podlinkpod"
+>shared()</a> – i.e. it’s an exclusive (write) lock – then
other locks should cause <a href="#request" class="podlinkpod"
+>request()</a> to fail.</p>
+
+<p>Returns: true on success, false on failure (sets the global error object
returned by Clownfish->error).</p>
+
+<h3><a class='u'
+name="release"
+>release</a></h3>
-<h2><a class='u' href='#___top' title='click to go to top of document'
-name="release()"
->release()</a></h2>
+<pre> $lock->release();</pre>
<p>Release the lock.</p>
-<h2><a class='u' href='#___top' title='click to go to top of document'
-name="is_locked()"
->is_locked()</a></h2>
+<h3><a class='u'
+name="is_locked"
+>is_locked</a></h3>
+
+<pre> my $retval = $lock->is_locked();</pre>
-<p>Indicate whether the resource identified by this lock's name is
currently locked.</p>
+<p>Indicate whether the resource identified by this lock’s name is
currently locked.</p>
<p>Returns: true if the resource is locked, false otherwise.</p>
-<h2><a class='u' href='#___top' title='click to go to top of document'
-name="clear_stale()"
->clear_stale()</a></h2>
+<h3><a class='u'
+name="clear_stale"
+>clear_stale</a></h3>
+
+<pre> $lock->clear_stale();</pre>
<p>Release all locks that meet the following three conditions: the lock name
matches, the host id matches, and the process id that the lock was created
under no longer identifies an active process.</p>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="METHODS"
->METHODS</a></h1>
+>METHODS</a></h2>
+
+<h3><a class='u'
+name="obtain"
+>obtain</a></h3>
-<h2><a class='u' href='#___top' title='click to go to top of document'
-name="obtain()"
->obtain()</a></h2>
+<pre> my $retval = $lock->obtain();</pre>
-<p>Call request() once per <code>interval</code> until request() returns
success or the <code>timeout</code> has been reached.</p>
+<p>Call <a href="#request" class="podlinkpod"
+>request()</a> once per <code>interval</code> until <a href="#request"
class="podlinkpod"
+>request()</a> returns success or the <code>timeout</code> has been
reached.</p>
-<p>Returns: true on success, false on failure (sets Clownfish->error).</p>
+<p>Returns: true on success, false on failure (sets the global error object
returned by Clownfish->error).</p>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="INHERITANCE"
->INHERITANCE</a></h1>
+>INHERITANCE</a></h2>
<p>Lucy::Store::Lock isa Clownfish::Obj.</p>
Modified: websites/staging/lucy/trunk/content/docs/test/Lucy/Store/LockErr.html
==============================================================================
--- websites/staging/lucy/trunk/content/docs/test/Lucy/Store/LockErr.html
(original)
+++ websites/staging/lucy/trunk/content/docs/test/Lucy/Store/LockErr.html Fri
Feb 26 12:52:42 2016
@@ -71,15 +71,15 @@
<div>
<a name='___top' class='dummyTopAnchor' ></a>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="NAME"
->NAME</a></h1>
+>NAME</a></h2>
<p>Lucy::Store::LockErr - Lock exception.</p>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="SYNOPSIS"
->SYNOPSIS</a></h1>
+>SYNOPSIS</a></h2>
<pre> while (1) {
my $bg_merger = eval {
@@ -95,16 +95,16 @@ name="SYNOPSIS"
...
}</pre>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="DESCRIPTION"
->DESCRIPTION</a></h1>
+>DESCRIPTION</a></h2>
<p>LockErr is a subclass of <a href="../../Clownfish/Err.html"
class="podlinkpod"
>Err</a> which indicates that a file locking problem occurred.</p>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="INHERITANCE"
->INHERITANCE</a></h1>
+>INHERITANCE</a></h2>
<p>Lucy::Store::LockErr isa Clownfish::Err isa Clownfish::Obj.</p>
Modified:
websites/staging/lucy/trunk/content/docs/test/Lucy/Store/LockFactory.html
==============================================================================
--- websites/staging/lucy/trunk/content/docs/test/Lucy/Store/LockFactory.html
(original)
+++ websites/staging/lucy/trunk/content/docs/test/Lucy/Store/LockFactory.html
Fri Feb 26 12:52:42 2016
@@ -71,15 +71,15 @@
<div>
<a name='___top' class='dummyTopAnchor' ></a>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="NAME"
->NAME</a></h1>
+>NAME</a></h2>
<p>Lucy::Store::LockFactory - Create Locks.</p>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="SYNOPSIS"
->SYNOPSIS</a></h1>
+>SYNOPSIS</a></h2>
<pre> use Sys::Hostname qw( hostname );
my $hostname = hostname() or die "Can't get unique hostname";
@@ -96,67 +96,86 @@ name="SYNOPSIS"
interval => 100,
);</pre>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="DESCRIPTION"
->DESCRIPTION</a></h1>
+>DESCRIPTION</a></h2>
<p>LockFactory is used to spin off interprocess mutex locks used by various
index reading and writing components. The default implementation uses
lockfiles, but LockFactory subclasses which are implemented using alternatives
such as flock() are possible.</p>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="CONSTRUCTORS"
->CONSTRUCTORS</a></h1>
+>CONSTRUCTORS</a></h2>
-<h2><a class='u' href='#___top' title='click to go to top of document'
-name="new(_[labeled_params]_)"
->new( <i>[labeled params]</i> )</a></h2>
+<h3><a class='u'
+name="new"
+>new</a></h3>
<pre> my $lock_factory = Lucy::Store::LockFactory->new(
folder => $folder, # required
host => $hostname, # required
);</pre>
+<p>Create a new LockFactory.</p>
+
<ul>
<li><b>folder</b> - A <a href="../../Lucy/Store/Folder.html" class="podlinkpod"
->Lucy::Store::Folder</a>.</li>
+>Folder</a>.</li>
<li><b>host</b> - An identifier which should be unique per-machine.</li>
</ul>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="METHODS"
->METHODS</a></h1>
+>METHODS</a></h2>
-<h2><a class='u' href='#___top' title='click to go to top of document'
-name="make_lock(_[labeled_params]_)"
->make_lock( <i>[labeled params]</i> )</a></h2>
+<h3><a class='u'
+name="make_lock"
+>make_lock</a></h3>
+
+<pre> my $retval = $lock_factory->make_lock(
+ name => $name # required
+ timeout => $timeout # default: 0
+ interval => $interval # default: 100
+ );</pre>
-<p>Return a Lock object, which, once obtain() returns successfully, maintains
an exclusive lock on a resource.</p>
+<p>Return a Lock object, which, once <a
href="../../Lucy/Store/Lock.html#obtain" class="podlinkpod"
+>obtain()</a> returns successfully, maintains an exclusive lock on a
resource.</p>
<ul>
<li><b>name</b> - A file-system-friendly id which identifies the resource to
be locked.</li>
-<li><b>timeout</b> - Time in milliseconds to keep retrying before abandoning
the attempt to obtain() a lock.</li>
+<li><b>timeout</b> - Time in milliseconds to keep retrying before abandoning
the attempt to <a href="../../Lucy/Store/Lock.html#obtain" class="podlinkpod"
+>obtain()</a> a lock.</li>
<li><b>interval</b> - Time in milliseconds between retries.</li>
</ul>
-<h2><a class='u' href='#___top' title='click to go to top of document'
-name="make_shared_lock(_[labeled_params]_)"
->make_shared_lock( <i>[labeled params]</i> )</a></h2>
+<h3><a class='u'
+name="make_shared_lock"
+>make_shared_lock</a></h3>
+
+<pre> my $retval = $lock_factory->make_shared_lock(
+ name => $name # required
+ timeout => $timeout # default: 0
+ interval => $interval # default: 100
+ );</pre>
-<p>Return a Lock object for which shared() returns true, and which maintains a
non-exclusive lock on a resource once obtain() returns success.</p>
+<p>Return a Lock object for which <a href="../../Lucy/Store/Lock.html#shared"
class="podlinkpod"
+>shared()</a> returns true, and which maintains a non-exclusive lock on a
resource once <a href="../../Lucy/Store/Lock.html#obtain" class="podlinkpod"
+>obtain()</a> returns success.</p>
<ul>
<li><b>name</b> - A file-system-friendly id which identifies the resource to
be locked.</li>
-<li><b>timeout</b> - Time in milliseconds to keep retrying before abandoning
the attempt to obtain() a lock.</li>
+<li><b>timeout</b> - Time in milliseconds to keep retrying before abandoning
the attempt to <a href="../../Lucy/Store/Lock.html#obtain" class="podlinkpod"
+>obtain()</a> a lock.</li>
<li><b>interval</b> - Time in milliseconds between retries.</li>
</ul>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="INHERITANCE"
->INHERITANCE</a></h1>
+>INHERITANCE</a></h2>
<p>Lucy::Store::LockFactory isa Clownfish::Obj.</p>
Modified:
websites/staging/lucy/trunk/content/docs/test/Lucy/Store/RAMFolder.html
==============================================================================
--- websites/staging/lucy/trunk/content/docs/test/Lucy/Store/RAMFolder.html
(original)
+++ websites/staging/lucy/trunk/content/docs/test/Lucy/Store/RAMFolder.html Fri
Feb 26 12:52:42 2016
@@ -71,15 +71,15 @@
<div>
<a name='___top' class='dummyTopAnchor' ></a>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="NAME"
->NAME</a></h1>
+>NAME</a></h2>
<p>Lucy::Store::RAMFolder - In-memory Folder implementation.</p>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="SYNOPSIS"
->SYNOPSIS</a></h1>
+>SYNOPSIS</a></h2>
<pre> my $folder = Lucy::Store::RAMFolder->new;
@@ -88,32 +88,34 @@ name="SYNOPSIS"
path => $relative_path,
);</pre>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="DESCRIPTION"
->DESCRIPTION</a></h1>
+>DESCRIPTION</a></h2>
<p>RAMFolder is an entirely in-memory implementation of <a
href="../../Lucy/Store/Folder.html" class="podlinkpod"
->Lucy::Store::Folder</a>, primarily used for testing and development.</p>
+>Folder</a>, primarily used for testing and development.</p>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="CONSTRUCTORS"
->CONSTRUCTORS</a></h1>
+>CONSTRUCTORS</a></h2>
-<h2><a class='u' href='#___top' title='click to go to top of document'
-name="new(_[labeled_params]_)"
->new( <i>[labeled params]</i> )</a></h2>
+<h3><a class='u'
+name="new"
+>new</a></h3>
<pre> my $folder = Lucy::Store::RAMFolder->new(
path => $relative_path, # default: empty string
);</pre>
+<p>Create a new RAMFolder.</p>
+
<ul>
<li><b>path</b> - Relative path, used for subfolders.</li>
</ul>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="INHERITANCE"
->INHERITANCE</a></h1>
+>INHERITANCE</a></h2>
<p>Lucy::Store::RAMFolder isa <a href="../../Lucy/Store/Folder.html"
class="podlinkpod"
>Lucy::Store::Folder</a> isa Clownfish::Obj.</p>
Modified:
websites/staging/lucy/trunk/content/docs/test/LucyX/Index/ByteBufDocReader.html
==============================================================================
---
websites/staging/lucy/trunk/content/docs/test/LucyX/Index/ByteBufDocReader.html
(original)
+++
websites/staging/lucy/trunk/content/docs/test/LucyX/Index/ByteBufDocReader.html
Fri Feb 26 12:52:42 2016
@@ -71,21 +71,21 @@
<div>
<a name='___top' class='dummyTopAnchor' ></a>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="NAME"
->NAME</a></h1>
+>NAME</a></h2>
<p>LucyX::Index::ByteBufDocReader - Read a Doc as a fixed-width byte array.</p>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="SYNOPSIS"
->SYNOPSIS</a></h1>
+>SYNOPSIS</a></h2>
<pre> # See LucyX::Index::ByteBufDocWriter</pre>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="DESCRIPTION"
->DESCRIPTION</a></h1>
+>DESCRIPTION</a></h2>
<p>This is a proof-of-concept class to demonstrate alternate implementations
for fetching documents. It is unsupported.</p>
Modified:
websites/staging/lucy/trunk/content/docs/test/LucyX/Index/ByteBufDocWriter.html
==============================================================================
---
websites/staging/lucy/trunk/content/docs/test/LucyX/Index/ByteBufDocWriter.html
(original)
+++
websites/staging/lucy/trunk/content/docs/test/LucyX/Index/ByteBufDocWriter.html
Fri Feb 26 12:52:42 2016
@@ -71,15 +71,15 @@
<div>
<a name='___top' class='dummyTopAnchor' ></a>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="NAME"
->NAME</a></h1>
+>NAME</a></h2>
<p>LucyX::Index::ByteBufDocWriter - Write a Doc as a fixed-width byte
array.</p>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="SYNOPSIS"
->SYNOPSIS</a></h1>
+>SYNOPSIS</a></h2>
<p>Create an <a href="../../Lucy/Plan/Architecture.html" class="podlinkpod"
>Architecture</a> subclass which overrides register_doc_writer() and
>register_doc_reader():</p>
@@ -146,9 +146,9 @@ name="SYNOPSIS"
...
}</pre>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="DESCRIPTION"
->DESCRIPTION</a></h1>
+>DESCRIPTION</a></h2>
<p>This is a proof-of-concept class to demonstrate alternate implementations
for fetching documents. It is unsupported.</p>
Modified:
websites/staging/lucy/trunk/content/docs/test/LucyX/Index/LongFieldSim.html
==============================================================================
--- websites/staging/lucy/trunk/content/docs/test/LucyX/Index/LongFieldSim.html
(original)
+++ websites/staging/lucy/trunk/content/docs/test/LucyX/Index/LongFieldSim.html
Fri Feb 26 12:52:42 2016
@@ -71,24 +71,24 @@
<div>
<a name='___top' class='dummyTopAnchor' ></a>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="NAME"
->NAME</a></h1>
+>NAME</a></h2>
<p>LucyX::Index::LongFieldSim - Similarity optimized for long fields.</p>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="SYNOPSIS"
->SYNOPSIS</a></h1>
+>SYNOPSIS</a></h2>
<pre> package MySchema::body;
use base qw( Lucy::Plan::FullTextType );
use LucyX::Index::LongFieldSim;
sub make_similarity { LucyX::Index::LongFieldSim->new }</pre>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="DESCRIPTION"
->DESCRIPTION</a></h1>
+>DESCRIPTION</a></h2>
<p>Apache Lucy's default <a href="../../Lucy/Index/Similarity.html"
class="podlinkpod"
>Similarity</a> implmentation produces a bias towards extremely short
>fields.</p>
Modified:
websites/staging/lucy/trunk/content/docs/test/LucyX/Index/ZlibDocReader.html
==============================================================================
---
websites/staging/lucy/trunk/content/docs/test/LucyX/Index/ZlibDocReader.html
(original)
+++
websites/staging/lucy/trunk/content/docs/test/LucyX/Index/ZlibDocReader.html
Fri Feb 26 12:52:42 2016
@@ -71,15 +71,15 @@
<div>
<a name='___top' class='dummyTopAnchor' ></a>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="NAME"
->NAME</a></h1>
+>NAME</a></h2>
<p>LucyX::Index::ZlibDocReader - Compressed doc storage.</p>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="DESCRIPTION"
->DESCRIPTION</a></h1>
+>DESCRIPTION</a></h2>
<p>This is a proof-of-concept class to demonstrate alternate implementations
for fetching documents.
It is unsupported.</p>
Modified:
websites/staging/lucy/trunk/content/docs/test/LucyX/Index/ZlibDocWriter.html
==============================================================================
---
websites/staging/lucy/trunk/content/docs/test/LucyX/Index/ZlibDocWriter.html
(original)
+++
websites/staging/lucy/trunk/content/docs/test/LucyX/Index/ZlibDocWriter.html
Fri Feb 26 12:52:42 2016
@@ -71,15 +71,15 @@
<div>
<a name='___top' class='dummyTopAnchor' ></a>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="NAME"
->NAME</a></h1>
+>NAME</a></h2>
<p>LucyX::Index::ZlibDocWriter - Compressed doc storage.</p>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="DESCRIPTION"
->DESCRIPTION</a></h1>
+>DESCRIPTION</a></h2>
<p>This is a proof-of-concept class to demonstrate alternate implementations
for fetching documents.
It is unsupported.</p>
Modified:
websites/staging/lucy/trunk/content/docs/test/LucyX/Remote/ClusterSearcher.html
==============================================================================
---
websites/staging/lucy/trunk/content/docs/test/LucyX/Remote/ClusterSearcher.html
(original)
+++
websites/staging/lucy/trunk/content/docs/test/LucyX/Remote/ClusterSearcher.html
Fri Feb 26 12:52:42 2016
@@ -71,15 +71,15 @@
<div>
<a name='___top' class='dummyTopAnchor' ></a>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="NAME"
->NAME</a></h1>
+>NAME</a></h2>
<p>LucyX::Remote::ClusterSearcher - Search multiple remote indexes.</p>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="SYNOPSIS"
->SYNOPSIS</a></h1>
+>SYNOPSIS</a></h2>
<pre> my $searcher = eval {
LucyX::Remote::ClusterSearcher->new(
@@ -90,21 +90,21 @@ name="SYNOPSIS"
...
my $hits = eval { $searcher->hits( query => $query ) };</pre>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="DESCRIPTION"
->DESCRIPTION</a></h1>
+>DESCRIPTION</a></h2>
<p>ClusterSearcher is a subclass of <a href="../../Lucy/Search/Searcher.html"
class="podlinkpod"
>Lucy::Search::Searcher</a> which can be used to search a composite index made
>up of multiple shards, where each shard is represented by a host:port pair
>running <a href="../../LucyX/Remote/SearchServer.html" class="podlinkpod"
>LucyX::Remote::SearchServer</a>.</p>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="METHODS"
->METHODS</a></h1>
+>METHODS</a></h2>
-<h2><a class='u' href='#___top' title='click to go to top of document'
+<h3><a class='u'
name="new"
->new</a></h2>
+>new</a></h3>
<p>Constructor. Takes hash-style params.</p>
Modified:
websites/staging/lucy/trunk/content/docs/test/LucyX/Remote/SearchClient.html
==============================================================================
---
websites/staging/lucy/trunk/content/docs/test/LucyX/Remote/SearchClient.html
(original)
+++
websites/staging/lucy/trunk/content/docs/test/LucyX/Remote/SearchClient.html
Fri Feb 26 12:52:42 2016
@@ -2,7 +2,7 @@
<html lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
- <title>- Apache Lucy Documentation</title>
+ <title>LucyX::Remote::SearchClient - Apache Lucy Documentation</title>
<link rel="stylesheet" type="text/css" media="screen"
href="http://lucy.apache.org/css/lucy.css">
</head>
@@ -75,6 +75,43 @@
For every call that does not close/terminate the socket connection,
expect a response back that's been serialized using Storable.</p>
+<h2><a class='u'
+name="NAME"
+>NAME</a></h2>
+
+<p>LucyX::Remote::SearchClient - Connect to a remote SearchServer.</p>
+
+<h2><a class='u'
+name="SYNOPSIS"
+>SYNOPSIS</a></h2>
+
+<pre> my $client = LucyX::Remote::SearchClient->new(
+ peer_address => 'searchserver1:7890',
+ );
+ my $hits = $client->hits( query => $query );</pre>
+
+<h2><a class='u'
+name="DESCRIPTION"
+>DESCRIPTION</a></h2>
+
+<p>SearchClient is a subclass of <a href="../../Lucy/Search/Searcher.html"
class="podlinkpod"
+>Lucy::Search::Searcher</a> which can be used to search an index on a remote
machine made accessible via <a href="../../LucyX/Remote/SearchServer.html"
class="podlinkpod"
+>SearchServer</a>.</p>
+
+<h2><a class='u'
+name="METHODS"
+>METHODS</a></h2>
+
+<h3><a class='u'
+name="new"
+>new</a></h3>
+
+<p>Constructor. Takes hash-style params.</p>
+
+<ul>
+<li><b>peer_address</b> - The name/IP and the port number which the client
should attempt to connect to.</li>
+</ul>
+
</div>
</div> <!-- lucy-main_content_box -->
Modified:
websites/staging/lucy/trunk/content/docs/test/LucyX/Remote/SearchServer.html
==============================================================================
---
websites/staging/lucy/trunk/content/docs/test/LucyX/Remote/SearchServer.html
(original)
+++
websites/staging/lucy/trunk/content/docs/test/LucyX/Remote/SearchServer.html
Fri Feb 26 12:52:42 2016
@@ -71,15 +71,15 @@
<div>
<a name='___top' class='dummyTopAnchor' ></a>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="NAME"
->NAME</a></h1>
+>NAME</a></h2>
<p>LucyX::Remote::SearchServer - Make a Searcher remotely accessible.</p>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="SYNOPSIS"
->SYNOPSIS</a></h1>
+>SYNOPSIS</a></h2>
<pre> my $searcher = Lucy::Search::IndexSearcher->new(
index => '/path/to/index'
@@ -91,9 +91,9 @@ name="SYNOPSIS"
port => 7890
);</pre>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="DESCRIPTION"
->DESCRIPTION</a></h1>
+>DESCRIPTION</a></h2>
<p>The SearchServer class, in conjunction with either <a
href="../../LucyX/Remote/SearchClient.html" class="podlinkpod"
>SearchClient</a> or <a href="../../LucyX/Remote/ClusterSearcher.html"
>class="podlinkpod"
@@ -101,13 +101,13 @@ name="DESCRIPTION"
<p>By aggregating several SearchClients under a ClusterSearcher, the cost of
searching what might have been a prohibitively large monolithic index can be
distributed across multiple nodes, each with its own, smaller index.</p>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="METHODS"
->METHODS</a></h1>
+>METHODS</a></h2>
-<h2><a class='u' href='#___top' title='click to go to top of document'
+<h3><a class='u'
name="new"
->new</a></h2>
+>new</a></h3>
<pre> my $search_server = LucyX::Remote::SearchServer->new(
searcher => $searcher, # required
@@ -120,9 +120,9 @@ name="new"
>Searcher</a> that the SearchServer will wrap.</li>
</ul>
-<h2><a class='u' href='#___top' title='click to go to top of document'
+<h3><a class='u'
name="serve"
->serve</a></h2>
+>serve</a></h3>
<pre> $search_server->serve(
port => 7890, # required
@@ -134,9 +134,9 @@ name="serve"
<li><b>port</b> - the port on localhost that the server should open and listen
on.</li>
</ul>
-<h2><a class='u' href='#___top' title='click to go to top of document'
+<h3><a class='u'
name="serve_rpc"
->serve_rpc</a></h2>
+>serve_rpc</a></h3>
<pre> my $status = $search_server->serve_rpc($sock);</pre>
Modified: websites/staging/lucy/trunk/content/docs/test/LucyX/Search/Filter.html
==============================================================================
--- websites/staging/lucy/trunk/content/docs/test/LucyX/Search/Filter.html
(original)
+++ websites/staging/lucy/trunk/content/docs/test/LucyX/Search/Filter.html Fri
Feb 26 12:52:42 2016
@@ -71,15 +71,15 @@
<div>
<a name='___top' class='dummyTopAnchor' ></a>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="NAME"
->NAME</a></h1>
+>NAME</a></h2>
<p>LucyX::Search::Filter - Build a caching filter based on results of a
Query.</p>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="SYNOPSIS"
->SYNOPSIS</a></h1>
+>SYNOPSIS</a></h2>
<pre> my %category_filters;
for my $category (qw( sweet sour salty bitter )) {
@@ -101,9 +101,9 @@ name="SYNOPSIS"
my $hits = $searcher->hits( query => $and_query );
...</pre>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="DESCRIPTION"
->DESCRIPTION</a></h1>
+>DESCRIPTION</a></h2>
<p>A Filter is a <a href="../../Lucy/Search/Query.html" class="podlinkpod"
>Lucy::Search::Query</a> subclass that can be used to filter the results of
>another Query. The effect is very similar to simply using the wrapped inner
>query, but there are two important differences:</p>
@@ -116,13 +116,13 @@ name="DESCRIPTION"
<p>To obtain logically equivalent results to the Filter but avoid the caching,
substitute the wrapped query but use set_boost() to set its <code>boost</code>
to 0.</p>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="METHODS"
->METHODS</a></h1>
+>METHODS</a></h2>
-<h2><a class='u' href='#___top' title='click to go to top of document'
+<h3><a class='u'
name="new"
->new</a></h2>
+>new</a></h3>
<pre> my $filter = LucyX::Search::Filter->new(
query => $query;
@@ -131,9 +131,9 @@ name="new"
<p>Constructor. Takes one hash-style parameter, <code>query</code>, which must
be an object belonging to a subclass of <a href="../../Lucy/Search/Query.html"
class="podlinkpod"
>Lucy::Search::Query</a>.</p>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="BUGS"
->BUGS</a></h1>
+>BUGS</a></h2>
<p>Filters do not cache when used in a search cluster with LucyX::Remote's
SearchServer and SearchClient.</p>
Modified:
websites/staging/lucy/trunk/content/docs/test/LucyX/Search/MockMatcher.html
==============================================================================
--- websites/staging/lucy/trunk/content/docs/test/LucyX/Search/MockMatcher.html
(original)
+++ websites/staging/lucy/trunk/content/docs/test/LucyX/Search/MockMatcher.html
Fri Feb 26 12:52:42 2016
@@ -71,15 +71,15 @@
<div>
<a name='___top' class='dummyTopAnchor' ></a>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="NAME"
->NAME</a></h1>
+>NAME</a></h2>
<p>LucyX::Search::MockMatcher - Matcher with arbitrary docs and scores.</p>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="DESCRIPTION"
->DESCRIPTION</a></h1>
+>DESCRIPTION</a></h2>
<p>Used for testing combining <a href="../../Lucy/Search/Matcher.html"
class="podlinkpod"
>Matchers</a> such as ANDMatcher,
@@ -88,13 +88,13 @@ obviating the need for clever index cons
<p>MockMatcher is a testing and demonstration class; it is unsupported.</p>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="CONSTRUCTORS"
->CONSTRUCTORS</a></h1>
+>CONSTRUCTORS</a></h2>
-<h2><a class='u' href='#___top' title='click to go to top of document'
+<h3><a class='u'
name="new(_[labeled_params]_)"
->new( [<i>labeled params</i>] )</a></h2>
+>new( [<i>labeled params</i>] )</a></h3>
<ul>
<li><b>doc_ids</b> - A sorted array of <a href="../../Lucy/Docs/DocIDs.html"
class="podlinkpod"
Modified:
websites/staging/lucy/trunk/content/docs/test/LucyX/Search/ProximityQuery.html
==============================================================================
---
websites/staging/lucy/trunk/content/docs/test/LucyX/Search/ProximityQuery.html
(original)
+++
websites/staging/lucy/trunk/content/docs/test/LucyX/Search/ProximityQuery.html
Fri Feb 26 12:52:42 2016
@@ -71,15 +71,15 @@
<div>
<a name='___top' class='dummyTopAnchor' ></a>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="NAME"
->NAME</a></h1>
+>NAME</a></h2>
<p>LucyX::Search::ProximityQuery - Query matching an ordered list of terms.</p>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="SYNOPSIS"
->SYNOPSIS</a></h1>
+>SYNOPSIS</a></h2>
<pre> my $proximity_query = LucyX::Search::ProximityQuery->new(
field => 'content',
@@ -88,20 +88,28 @@ name="SYNOPSIS"
);
my $hits = $searcher->hits( query => $proximity_query );</pre>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="DESCRIPTION"
->DESCRIPTION</a></h1>
+>DESCRIPTION</a></h2>
<p>ProximityQuery is a subclass of <a href="../../Lucy/Search/Query.html"
class="podlinkpod"
->Lucy::Search::Query</a> for matching against an ordered sequence of terms.</p>
+>Query</a> for matching against an ordered sequence of terms.</p>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="CONSTRUCTORS"
->CONSTRUCTORS</a></h1>
+>CONSTRUCTORS</a></h2>
-<h2><a class='u' href='#___top' title='click to go to top of document'
-name="new(_[labeled_params]_)"
->new( <i>[labeled params]</i> )</a></h2>
+<h3><a class='u'
+name="new"
+>new</a></h3>
+
+<pre> my $proximity_query = LucyX::Search::ProximityQuery->new(
+ field => $field # required
+ terms => $terms # required
+ within => $within # required
+ );</pre>
+
+<p>Create a new ProximityQuery.</p>
<ul>
<li><b>field</b> - The field that the phrase must occur in.</li>
@@ -109,31 +117,58 @@ name="new(_[labeled_params]_)"
<li><b>terms</b> - The ordered array of terms that must match.</li>
</ul>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="METHODS"
->METHODS</a></h1>
+>METHODS</a></h2>
+
+<h3><a class='u'
+name="get_field"
+>get_field</a></h3>
+
+<pre> my $retval = $proximity_query->get_field();</pre>
+
+<p>Accessor for object’s field attribute.</p>
+
+<h3><a class='u'
+name="get_terms"
+>get_terms</a></h3>
+
+<pre> my $retval = $proximity_query->get_terms();</pre>
-<h2><a class='u' href='#___top' title='click to go to top of document'
-name="get_field()"
->get_field()</a></h2>
+<p>Accessor for object’s array of terms.</p>
-<p>Accessor for object's field attribute.</p>
+<h3><a class='u'
+name="get_within"
+>get_within</a></h3>
-<h2><a class='u' href='#___top' title='click to go to top of document'
-name="get_terms()"
->get_terms()</a></h2>
+<pre> my $retval = $proximity_query->get_within();</pre>
-<p>Accessor for object's array of terms.</p>
+<p>Accessor for object’s within attribute.</p>
-<h2><a class='u' href='#___top' title='click to go to top of document'
-name="get_within()"
->get_within()</a></h2>
+<h3><a class='u'
+name="make_compiler"
+>make_compiler</a></h3>
-<p>Accessor for object's within attribute.</p>
+<pre> my $retval = $proximity_query->make_compiler(
+ searcher => $searcher # required
+ boost => $boost # required
+ subordinate => $subordinate # default: false
+ );</pre>
+
+<p>Abstract factory method returning a Compiler derived from this Query.</p>
+
+<ul>
+<li><b>searcher</b> - A Searcher.</li>
+
+<li><b>boost</b> - A scoring multiplier.</li>
+
+<li><b>subordinate</b> - Indicates whether the Query is a subquery (as opposed
to a top-level query). If false, the implementation must invoke <a
href="../../Lucy/Search/Compiler.html#normalize" class="podlinkpod"
+>normalize()</a> on the newly minted Compiler object before returning it.</li>
+</ul>
-<h1><a class='u' href='#___top' title='click to go to top of document'
+<h2><a class='u'
name="INHERITANCE"
->INHERITANCE</a></h1>
+>INHERITANCE</a></h2>
<p>LucyX::Search::ProximityQuery isa <a href="../../Lucy/Search/Query.html"
class="podlinkpod"
>Lucy::Search::Query</a> isa Clownfish::Obj.</p>
Added: websites/staging/lucy/trunk/content/docs/test/index.html
==============================================================================
--- websites/staging/lucy/trunk/content/docs/test/index.html (added)
+++ websites/staging/lucy/trunk/content/docs/test/index.html Fri Feb 26
12:52:42 2016
@@ -0,0 +1,193 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html lang="en">
+ <head>
+ <meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
+ <title>Perl API documentation for Apache Lucy 0.5.0</title>
+ <link rel="stylesheet" type="text/css" media="screen"
href="http://lucy.apache.org/css/lucy.css">
+ </head>
+
+ <body>
+
+ <div id="lucy-rigid_wrapper">
+
+ <div id="lucy-top" class="container_16 lucy-white_box_3d">
+
+ <div id="lucy-logo_box" class="grid_8">
+ <a href="/"><img
src="http://lucy.apache.org/images/lucy_logo_150x100.png" alt="Apache
Lucyâ¢"></a>
+ </div> <!-- lucy-logo_box -->
+
+ <div #id="lucy-top_nav_box" class="grid_8">
+ <div id="lucy-top_nav_bar" class="container_8">
+ <ul>
+ <li><a href="http://www.apache.org/" title="Apache Software
Foundation">Apache Software Foundation</a></li>
+ <li><a href="http://www.apache.org/licenses/"
title="License">License</a></li>
+ <li><a href="http://www.apache.org/foundation/sponsorship.html"
title="Sponsorship">Sponsorship</a></li>
+ <li><a href="http://www.apache.org/foundation/thanks.html"
title="Thanks">Thanks</a></li>
+ <li><a href="http://www.apache.org/security/ "
title="Security">Security</a></li>
+ </ul>
+ </div> <!-- lucy-top_nav_bar -->
+ <p><a href="http://www.apache.org/">Apache</a> » <a
href="/">Lucy</a> » <a
href="/docs/">Docs</a> » <a href="/docs/test/">Test</a></p>
+ <form name="lucy-top_search_box" id="lucy-top_search_box"
action="http://www.google.com/search" method="get">
+ <input value="*.apache.org" name="sitesearch" type="hidden"/>
+ <input type="text" name="q" id="query" style="width:85%">
+ <input type="submit" id="submit" value="Search">
+ </form>
+ </div> <!-- lucy-top_nav_box -->
+
+ <div class="clear"></div>
+
+ </div> <!-- lucy-top -->
+
+ <div id="lucy-main_content" class="container_16 lucy-white_box_3d">
+
+ <div class="grid_4" id="lucy-left_nav_box">
+ <h6>About</h6>
+ <ul>
+ <li><a href="/">Welcome</a></li>
+ <li><a href="/clownfish.html">Clownfish</a></li>
+ <li><a href="/faq.html">FAQ</a></li>
+ <li><a href="/people.html">People</a></li>
+ </ul>
+ <h6>Resources</h6>
+ <ul>
+ <li><a href="/download.html">Download</a></li>
+ <li><a href="/mailing_lists.html">Mailing Lists</a></li>
+ <li><a href="/docs/perl/">Documentation</a></li>
+ <li><a href="http://wiki.apache.org/lucy/">Wiki</a></li>
+ <li><a href="https://issues.apache.org/jira/browse/LUCY">Issue
Tracker</a></li>
+ <li><a href="/version_control.html">Version Control</a></li>
+ </ul>
+ <h6>Related Projects</h6>
+ <ul>
+ <li><a href="http://lucene.apache.org/java/">Lucene</a></li>
+ <li><a href="http://lucene.apache.org/solr/">Solr</a></li>
+ <li><a
href="http://incubator.apache.org/lucene.net/">Lucene.NET</a></li>
+ <li><a
href="http://lucene.apache.org/pylucene/">PyLucene</a></li>
+ <li><a href="http://lucene.apache.org/openrelevance/">Open
Relevance</a></li>
+ </ul>
+ </div> <!-- lucy-left_nav_box -->
+
+ <div id="lucy-main_content_box" class="grid_9">
+ <h2>Perl API documentation for Apache Lucy 0.5.0</h2>
+
+<ul>
+<li><a href="Lucy.html">Lucy</a> - Apache Lucy search engine library.</li>
+<li><a href="Lucy/Analysis/Analyzer.html">Lucy::Analysis::Analyzer</a> -
Tokenize/modify/filter text.</li>
+<li><a href="Lucy/Analysis/CaseFolder.html">Lucy::Analysis::CaseFolder</a> -
Normalize case, facilitating case-insensitive search.</li>
+<li><a href="Lucy/Analysis/EasyAnalyzer.html">Lucy::Analysis::EasyAnalyzer</a>
- A simple analyzer chain.</li>
+<li><a href="Lucy/Analysis/Inversion.html">Lucy::Analysis::Inversion</a> - A
collection of Tokens.</li>
+<li><a href="Lucy/Analysis/Normalizer.html">Lucy::Analysis::Normalizer</a> -
Unicode normalization, case folding and accent stripping.</li>
+<li><a href="Lucy/Analysis/PolyAnalyzer.html">Lucy::Analysis::PolyAnalyzer</a>
- Multiple Analyzers in series.</li>
+<li><a
href="Lucy/Analysis/RegexTokenizer.html">Lucy::Analysis::RegexTokenizer</a> -
Split a string into tokens.</li>
+<li><a
href="Lucy/Analysis/SnowballStemmer.html">Lucy::Analysis::SnowballStemmer</a> -
Reduce related words to a shared root.</li>
+<li><a
href="Lucy/Analysis/SnowballStopFilter.html">Lucy::Analysis::SnowballStopFilter</a>
- Suppress a âstoplistâ of common words.</li>
+<li><a
href="Lucy/Analysis/StandardTokenizer.html">Lucy::Analysis::StandardTokenizer</a>
- Split a string into tokens.</li>
+<li><a href="Lucy/Analysis/Token.html">Lucy::Analysis::Token</a> - Unit of
text.</li>
+<li><a href="Lucy/Docs/Cookbook.html">Lucy::Docs::Cookbook</a> - Apache Lucy
recipes</li>
+<li><a
href="Lucy/Docs/Cookbook/CustomQuery.html">Lucy::Docs::Cookbook::CustomQuery</a>
- Sample subclass of Query</li>
+<li><a
href="Lucy/Docs/Cookbook/CustomQueryParser.html">Lucy::Docs::Cookbook::CustomQueryParser</a>
- Sample subclass of QueryParser.</li>
+<li><a
href="Lucy/Docs/Cookbook/FastUpdates.html">Lucy::Docs::Cookbook::FastUpdates</a>
- Near real-time index updates</li>
+<li><a href="Lucy/Docs/DevGuide.html">Lucy::Docs::DevGuide</a> - Quick-start
guide to hacking on Apache Lucy.</li>
+<li><a href="Lucy/Docs/DocIDs.html">Lucy::Docs::DocIDs</a> - Characteristics
of Apache Lucy document ids.</li>
+<li><a href="Lucy/Docs/FileFormat.html">Lucy::Docs::FileFormat</a> - Overview
of index file format</li>
+<li><a href="Lucy/Docs/FileLocking.html">Lucy::Docs::FileLocking</a> - Manage
indexes on shared volumes.</li>
+<li><a href="Lucy/Docs/IRTheory.html">Lucy::Docs::IRTheory</a> - Crash course
in information retrieval</li>
+<li><a href="Lucy/Docs/Tutorial.html">Lucy::Docs::Tutorial</a> - Step-by-step
introduction to Apache Lucy.</li>
+<li><a
href="Lucy/Docs/Tutorial/AnalysisTutorial.html">Lucy::Docs::Tutorial::AnalysisTutorial</a>
- How to choose and use Analyzers.</li>
+<li><a
href="Lucy/Docs/Tutorial/BeyondSimpleTutorial.html">Lucy::Docs::Tutorial::BeyondSimpleTutorial</a>
- A more flexible app structure.</li>
+<li><a
href="Lucy/Docs/Tutorial/FieldTypeTutorial.html">Lucy::Docs::Tutorial::FieldTypeTutorial</a>
- Specify per-field properties and behaviors.</li>
+<li><a
href="Lucy/Docs/Tutorial/HighlighterTutorial.html">Lucy::Docs::Tutorial::HighlighterTutorial</a>
- Augment search results with highlighted excerpts.</li>
+<li><a
href="Lucy/Docs/Tutorial/QueryObjectsTutorial.html">Lucy::Docs::Tutorial::QueryObjectsTutorial</a>
- Use Query objects instead of query strings.</li>
+<li><a
href="Lucy/Docs/Tutorial/SimpleTutorial.html">Lucy::Docs::Tutorial::SimpleTutorial</a>
- Bare-bones search app.</li>
+<li><a href="Lucy/Document/Doc.html">Lucy::Document::Doc</a> - A document.</li>
+<li><a href="Lucy/Document/HitDoc.html">Lucy::Document::HitDoc</a> - A
document read from an index.</li>
+<li><a href="Lucy/Highlight/Highlighter.html">Lucy::Highlight::Highlighter</a>
- Create and highlight excerpts.</li>
+<li><a
href="Lucy/Index/BackgroundMerger.html">Lucy::Index::BackgroundMerger</a> -
Consolidate index segments in the background.</li>
+<li><a href="Lucy/Index/DataReader.html">Lucy::Index::DataReader</a> -
Abstract base class for reading index data.</li>
+<li><a href="Lucy/Index/DataWriter.html">Lucy::Index::DataWriter</a> - Write
data to an index.</li>
+<li><a href="Lucy/Index/DeletionsWriter.html">Lucy::Index::DeletionsWriter</a>
- Abstract base class for marking documents as deleted.</li>
+<li><a href="Lucy/Index/DocReader.html">Lucy::Index::DocReader</a> - Retrieve
stored documents.</li>
+<li><a href="Lucy/Index/IndexManager.html">Lucy::Index::IndexManager</a> -
Policies governing index updating, locking, and file deletion.</li>
+<li><a href="Lucy/Index/IndexReader.html">Lucy::Index::IndexReader</a> - Read
from an inverted index.</li>
+<li><a href="Lucy/Index/Indexer.html">Lucy::Index::Indexer</a> - Build
inverted indexes.</li>
+<li><a href="Lucy/Index/Lexicon.html">Lucy::Index::Lexicon</a> - Iterator for
a fieldâs terms.</li>
+<li><a href="Lucy/Index/LexiconReader.html">Lucy::Index::LexiconReader</a> -
Read Lexicon data.</li>
+<li><a href="Lucy/Index/PolyReader.html">Lucy::Index::PolyReader</a> -
Multi-segment implementation of IndexReader.</li>
+<li><a href="Lucy/Index/PostingList.html">Lucy::Index::PostingList</a> -
Term-Document pairings.</li>
+<li><a
href="Lucy/Index/PostingListReader.html">Lucy::Index::PostingListReader</a> -
Read postings data.</li>
+<li><a href="Lucy/Index/SegReader.html">Lucy::Index::SegReader</a> -
Single-segment IndexReader.</li>
+<li><a href="Lucy/Index/SegWriter.html">Lucy::Index::SegWriter</a> - Write one
segment of an index.</li>
+<li><a href="Lucy/Index/Segment.html">Lucy::Index::Segment</a> - Warehouse for
information about one segment of an inverted index.</li>
+<li><a href="Lucy/Index/Similarity.html">Lucy::Index::Similarity</a> - Judge
how well a document matches a query.</li>
+<li><a href="Lucy/Index/Snapshot.html">Lucy::Index::Snapshot</a> -
Point-in-time index file list.</li>
+<li><a href="Lucy/Object/BitVector.html">Lucy::Object::BitVector</a> - An
array of bits.</li>
+<li><a href="Lucy/Object/Obj.html">Lucy::Object::Obj</a> - Moved.</li>
+<li><a href="Lucy/Plan/Architecture.html">Lucy::Plan::Architecture</a> -
Configure major components of an index.</li>
+<li><a href="Lucy/Plan/BlobType.html">Lucy::Plan::BlobType</a> - Default
behaviors for binary fields.</li>
+<li><a href="Lucy/Plan/FieldType.html">Lucy::Plan::FieldType</a> - Define a
fieldâs behavior.</li>
+<li><a href="Lucy/Plan/FullTextType.html">Lucy::Plan::FullTextType</a> -
Full-text search field type.</li>
+<li><a href="Lucy/Plan/Schema.html">Lucy::Plan::Schema</a> - User-created
specification for an inverted index.</li>
+<li><a href="Lucy/Plan/StringType.html">Lucy::Plan::StringType</a> -
Non-tokenized text type.</li>
+<li><a href="Lucy/Search/ANDQuery.html">Lucy::Search::ANDQuery</a> - Intersect
multiple result sets.</li>
+<li><a href="Lucy/Search/Collector.html">Lucy::Search::Collector</a> - Process
hits.</li>
+<li><a
href="Lucy/Search/Collector/BitCollector.html">Lucy::Search::Collector::BitCollector</a>
- Collector which records doc nums in a BitVector.</li>
+<li><a href="Lucy/Search/Compiler.html">Lucy::Search::Compiler</a> -
Query-to-Matcher compiler.</li>
+<li><a href="Lucy/Search/Hits.html">Lucy::Search::Hits</a> - Access search
results.</li>
+<li><a href="Lucy/Search/IndexSearcher.html">Lucy::Search::IndexSearcher</a> -
Execute searches against a single index.</li>
+<li><a href="Lucy/Search/LeafQuery.html">Lucy::Search::LeafQuery</a> - Leaf
node in a tree created by QueryParser.</li>
+<li><a href="Lucy/Search/MatchAllQuery.html">Lucy::Search::MatchAllQuery</a> -
Query which matches all documents.</li>
+<li><a href="Lucy/Search/Matcher.html">Lucy::Search::Matcher</a> - Match a set
of document ids.</li>
+<li><a href="Lucy/Search/NOTQuery.html">Lucy::Search::NOTQuery</a> - Invert
the result set of another Query.</li>
+<li><a href="Lucy/Search/NoMatchQuery.html">Lucy::Search::NoMatchQuery</a> -
Query which matches no documents.</li>
+<li><a href="Lucy/Search/ORQuery.html">Lucy::Search::ORQuery</a> - Union
multiple result sets.</li>
+<li><a href="Lucy/Search/PhraseQuery.html">Lucy::Search::PhraseQuery</a> -
Query matching an ordered list of terms.</li>
+<li><a href="Lucy/Search/PolyQuery.html">Lucy::Search::PolyQuery</a> - Base
class for composite Query objects.</li>
+<li><a href="Lucy/Search/PolySearcher.html">Lucy::Search::PolySearcher</a> -
Aggregate results from multiple Searchers.</li>
+<li><a href="Lucy/Search/Query.html">Lucy::Search::Query</a> - A specification
for a search query.</li>
+<li><a href="Lucy/Search/QueryParser.html">Lucy::Search::QueryParser</a> -
Transform a string into a Query object.</li>
+<li><a href="Lucy/Search/RangeQuery.html">Lucy::Search::RangeQuery</a> - Match
a range of values.</li>
+<li><a
href="Lucy/Search/RequiredOptionalQuery.html">Lucy::Search::RequiredOptionalQuery</a>
- Join results for two Queries, one required, one optional.</li>
+<li><a href="Lucy/Search/Searcher.html">Lucy::Search::Searcher</a> - Base
class for searching collections of documents.</li>
+<li><a href="Lucy/Search/SortRule.html">Lucy::Search::SortRule</a> - Element
of a SortSpec.</li>
+<li><a href="Lucy/Search/SortSpec.html">Lucy::Search::SortSpec</a> - Specify a
custom sort order for search results.</li>
+<li><a href="Lucy/Search/Span.html">Lucy::Search::Span</a> - An offset, a
length, and a weight.</li>
+<li><a href="Lucy/Search/TermQuery.html">Lucy::Search::TermQuery</a> - Query
which matches individual terms.</li>
+<li><a href="Lucy/Simple.html">Lucy::Simple</a> - Basic search engine.</li>
+<li><a href="Lucy/Store/FSFolder.html">Lucy::Store::FSFolder</a> - File System
implementation of Folder.</li>
+<li><a href="Lucy/Store/Folder.html">Lucy::Store::Folder</a> - Abstract class
representing a directory.</li>
+<li><a href="Lucy/Store/Lock.html">Lucy::Store::Lock</a> - Abstract class
representing an interprocess mutex lock.</li>
+<li><a href="Lucy/Store/LockErr.html">Lucy::Store::LockErr</a> - Lock
exception.</li>
+<li><a href="Lucy/Store/LockFactory.html">Lucy::Store::LockFactory</a> -
Create Locks.</li>
+<li><a href="Lucy/Store/RAMFolder.html">Lucy::Store::RAMFolder</a> - In-memory
Folder implementation.</li>
+<li><a
href="LucyX/Index/ByteBufDocReader.html">LucyX::Index::ByteBufDocReader</a> -
Read a Doc as a fixed-width byte array.</li>
+<li><a
href="LucyX/Index/ByteBufDocWriter.html">LucyX::Index::ByteBufDocWriter</a> -
Write a Doc as a fixed-width byte array.</li>
+<li><a href="LucyX/Index/LongFieldSim.html">LucyX::Index::LongFieldSim</a> -
Similarity optimized for long fields.</li>
+<li><a href="LucyX/Index/ZlibDocReader.html">LucyX::Index::ZlibDocReader</a> -
Compressed doc storage.</li>
+<li><a href="LucyX/Index/ZlibDocWriter.html">LucyX::Index::ZlibDocWriter</a> -
Compressed doc storage.</li>
+<li><a
href="LucyX/Remote/ClusterSearcher.html">LucyX::Remote::ClusterSearcher</a> -
Search multiple remote indexes.</li>
+<li><a href="LucyX/Remote/SearchClient.html">LucyX::Remote::SearchClient</a> -
Connect to a remote SearchServer.</li>
+<li><a href="LucyX/Remote/SearchServer.html">LucyX::Remote::SearchServer</a> -
Make a Searcher remotely accessible.</li>
+<li><a href="LucyX/Search/Filter.html">LucyX::Search::Filter</a> - Build a
caching filter based on results of a Query.</li>
+<li><a href="LucyX/Search/MockMatcher.html">LucyX::Search::MockMatcher</a> -
Matcher with arbitrary docs and scores.</li>
+<li><a
href="LucyX/Search/ProximityQuery.html">LucyX::Search::ProximityQuery</a> -
Query matching an ordered list of terms.</li>
+</ul>
+
+ </div> <!-- lucy-main_content_box -->
+ <div class="clear"></div>
+
+ </div> <!-- lucy-main_content -->
+
+ <div id="lucy-copyright" class="container_16">
+ <p>Copyright © 2010-2015 The Apache Software Foundation, Licensed
under the
+ <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache
License, Version 2.0</a>.
+ <br/>
+ Apache Lucy, Lucy, Apache, the Apache feather logo, and the Apache
Lucy project logo are trademarks of The
+ Apache Software Foundation. All other marks mentioned may be
trademarks or registered trademarks of their
+ respective owners.
+ </p>
+ </div> <!-- lucy-copyright -->
+
+ </div> <!-- lucy-rigid_wrapper -->
+
+ </body>
+</html>