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 13:44:48 2016
@@ -81,9 +81,9 @@ name="NAME"
 name="SYNOPSIS"
 >SYNOPSIS</a></h2>
 
-<pre>    my $folder = Lucy::Store::FSFolder-&#62;new(
-        path =&#62; &#39;/path/to/folder&#39;,
-    );</pre>
+<pre>my $folder = Lucy::Store::FSFolder-&#62;new(
+    path =&#62; &#39;/path/to/folder&#39;,
+);</pre>
 
 <h2><a class='u'
 name="DESCRIPTION"
@@ -100,14 +100,17 @@ name="CONSTRUCTORS"
 name="new"
 >new</a></h3>
 
-<pre>    my $folder = Lucy::Store::FSFolder-&#62;new(
-        path =&#62; &#39;/path/to/folder&#39;,
-    );</pre>
+<pre>my $folder = Lucy::Store::FSFolder-&#62;new(
+    path =&#62; &#39;/path/to/folder&#39;,
+);</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 &#8211; 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 
&#8211; so it may be necessary to create the directory yourself.</li>
 </ul>
 
 <h2><a class='u'

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 13:44:48 2016
@@ -81,16 +81,22 @@ name="NAME"
 name="SYNOPSIS"
 >SYNOPSIS</a></h2>
 
-<pre>    # Abstract base class.</pre>
+<pre># Abstract base class.</pre>
 
 <h2><a class='u'
 name="DESCRIPTION"
 >DESCRIPTION</a></h2>
 
-<p>A &#8220;file&#8221; within a Folder might be a real file on disk &#8211; 
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 &#8220;file&#8221; within a Folder might be a real file on disk &#8211; 
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>
+<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>
 
 <h2><a class='u'
 name="INHERITANCE"

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 13:44:48 2016
@@ -81,21 +81,24 @@ name="NAME"
 name="SYNOPSIS"
 >SYNOPSIS</a></h2>
 
-<pre>    my $lock = $lock_factory-&#62;make_lock(
-        name    =&#62; &#39;write&#39;,
-        timeout =&#62; 5000,
-    );
-    $lock-&#62;obtain or die &#34;can&#39;t get lock for &#34; . 
$lock-&#62;get_name;
-    do_stuff();
-    $lock-&#62;release;</pre>
+<pre>my $lock = $lock_factory-&#62;make_lock(
+    name    =&#62; &#39;write&#39;,
+    timeout =&#62; 5000,
+);
+$lock-&#62;obtain or die &#34;can&#39;t get lock for &#34; . 
$lock-&#62;get_name;
+do_stuff();
+$lock-&#62;release;</pre>
 
 <h2><a class='u'
 name="DESCRIPTION"
 >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>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 &#8220;host&#8221; 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 &#8220;host&#8221; id which should be unique per machine; 
it is used to help clear away stale locks.</p>
 
 <h2><a class='u'
 name="CONSTRUCTORS"
@@ -105,20 +108,21 @@ name="CONSTRUCTORS"
 name="new"
 >new</a></h3>
 
-<pre>    my $lock = Lucy::Store::Lock-&#62;new(
-        name     =&#62; &#39;commit&#39;,     # required
-        folder   =&#62; $folder,      # required
-        host     =&#62; $hostname,    # required
-        timeout  =&#62; 5000,         # default: 0
-        interval =&#62; 1000,         # default: 100
-    );</pre>
+<pre>my $lock = Lucy::Store::Lock-&#62;new(
+    name     =&#62; &#39;commit&#39;,     # required
+    folder   =&#62; $folder,      # required
+    host     =&#62; $hostname,    # required
+    timeout  =&#62; 5000,         # default: 0
+    interval =&#62; 1000,         # default: 100
+);</pre>
 
 <p>Abstract constructor.</p>
 
 <ul>
 <li><b>folder</b> - A Folder.</li>
 
-<li><b>name</b> - String identifying the resource to be locked, which must 
consist solely of characters matching [-_.A-Za-z0-9].</li>
+<li><b>name</b> - String identifying the resource to be locked,
+which must consist solely of characters matching [-_.A-Za-z0-9].</li>
 
 <li><b>host</b> - A unique per-machine identifier.</li>
 
@@ -136,33 +140,39 @@ name="ABSTRACT_METHODS"
 name="shared"
 >shared</a></h3>
 
-<pre>    my $retval = $lock-&#62;shared();</pre>
+<pre>my $retval = $lock-&#62;shared();</pre>
 
-<p>Returns true if the Lock is shared, false if the Lock is exclusive.</p>
+<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-&#62;request();</pre>
+<pre>my $retval = $lock-&#62;request();</pre>
 
 <p>Make one attempt to acquire the lock.</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> &#8211; i.e. it&#8217;s an exclusive (write) lock &#8211; then 
other locks should cause <a href="#request" 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> &#8211; i.e.
+it&#8217;s an exclusive (write) lock &#8211; 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-&#62;error).</p>
+<p>Returns: true on success,
+false on failure (sets the global error object returned by 
Clownfish-&#62;error).</p>
 
 <h3><a class='u'
 name="release"
 >release</a></h3>
 
-<pre>    $lock-&#62;release();</pre>
+<pre>$lock-&#62;release();</pre>
 
 <p>Release the lock.</p>
 
@@ -170,19 +180,22 @@ name="release"
 name="is_locked"
 >is_locked</a></h3>
 
-<pre>    my $retval = $lock-&#62;is_locked();</pre>
+<pre>my $retval = $lock-&#62;is_locked();</pre>
 
 <p>Indicate whether the resource identified by this lock&#8217;s name is 
currently locked.</p>
 
-<p>Returns: true if the resource is locked, false otherwise.</p>
+<p>Returns: true if the resource is locked,
+false otherwise.</p>
 
 <h3><a class='u'
 name="clear_stale"
 >clear_stale</a></h3>
 
-<pre>    $lock-&#62;clear_stale();</pre>
+<pre>$lock-&#62;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>
+<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>
 
 <h2><a class='u'
 name="METHODS"
@@ -192,13 +205,14 @@ name="METHODS"
 name="obtain"
 >obtain</a></h3>
 
-<pre>    my $retval = $lock-&#62;obtain();</pre>
+<pre>my $retval = $lock-&#62;obtain();</pre>
 
 <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 the global error object 
returned by Clownfish-&#62;error).</p>
+<p>Returns: true on success,
+false on failure (sets the global error object returned by 
Clownfish-&#62;error).</p>
 
 <h2><a class='u'
 name="INHERITANCE"

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 13:44:48 2016
@@ -81,19 +81,19 @@ name="NAME"
 name="SYNOPSIS"
 >SYNOPSIS</a></h2>
 
-<pre>    while (1) {
-        my $bg_merger = eval {
-            Lucy::Index::BackgroundMerger-&#62;new( index =&#62; $index );
-        };
-        if ( blessed($@) and $@-&#62;isa(&#34;Lucy::Store::LockErr&#34;) ) {
-            warn &#34;Retrying...\n&#34;;
-        }
-        elsif (!$bg_merger) {
-            # Re-throw.
-            die &#34;Failed to open BackgroundMerger: $@&#34;;
-        }
-        ...
-    }</pre>
+<pre>while (1) {
+    my $bg_merger = eval {
+        Lucy::Index::BackgroundMerger-&#62;new( index =&#62; $index );
+    };
+    if ( blessed($@) and $@-&#62;isa(&#34;Lucy::Store::LockErr&#34;) ) {
+        warn &#34;Retrying...\n&#34;;
+    }
+    elsif (!$bg_merger) {
+        # Re-throw.
+        die &#34;Failed to open BackgroundMerger: $@&#34;;
+    }
+    ...
+}</pre>
 
 <h2><a class='u'
 name="DESCRIPTION"

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 13:44:48 2016
@@ -81,26 +81,28 @@ name="NAME"
 name="SYNOPSIS"
 >SYNOPSIS</a></h2>
 
-<pre>    use Sys::Hostname qw( hostname );
-    my $hostname = hostname() or die &#34;Can&#39;t get unique hostname&#34;;
-    my $folder = Lucy::Store::FSFolder-&#62;new( 
-        path =&#62; &#39;/path/to/index&#39;, 
-    );
-    my $lock_factory = Lucy::Store::LockFactory-&#62;new(
-        folder =&#62; $folder,
-        host   =&#62; $hostname,
-    );
-    my $write_lock = $lock_factory-&#62;make_lock(
-        name     =&#62; &#39;write&#39;,
-        timeout  =&#62; 5000,
-        interval =&#62; 100,
-    );</pre>
+<pre>use Sys::Hostname qw( hostname );
+my $hostname = hostname() or die &#34;Can&#39;t get unique hostname&#34;;
+my $folder = Lucy::Store::FSFolder-&#62;new( 
+    path =&#62; &#39;/path/to/index&#39;, 
+);
+my $lock_factory = Lucy::Store::LockFactory-&#62;new(
+    folder =&#62; $folder,
+    host   =&#62; $hostname,
+);
+my $write_lock = $lock_factory-&#62;make_lock(
+    name     =&#62; &#39;write&#39;,
+    timeout  =&#62; 5000,
+    interval =&#62; 100,
+);</pre>
 
 <h2><a class='u'
 name="DESCRIPTION"
 >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>
+<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>
 
 <h2><a class='u'
 name="CONSTRUCTORS"
@@ -110,10 +112,10 @@ name="CONSTRUCTORS"
 name="new"
 >new</a></h3>
 
-<pre>    my $lock_factory = Lucy::Store::LockFactory-&#62;new(
-        folder =&#62; $folder,      # required
-        host   =&#62; $hostname,    # required
-    );</pre>
+<pre>my $lock_factory = Lucy::Store::LockFactory-&#62;new(
+    folder =&#62; $folder,      # required
+    host   =&#62; $hostname,    # required
+);</pre>
 
 <p>Create a new LockFactory.</p>
 
@@ -132,14 +134,17 @@ name="METHODS"
 name="make_lock"
 >make_lock</a></h3>
 
-<pre>    my $retval = $lock_factory-&#62;make_lock(
-        name     =&#62; $name      # required
-        timeout  =&#62; $timeout   # default: 0
-        interval =&#62; $interval  # default: 100
-    );</pre>
-
-<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>
+<pre>my $retval = $lock_factory-&#62;make_lock(
+    name     =&#62; $name      # required
+    timeout  =&#62; $timeout   # default: 0
+    interval =&#62; $interval  # default: 100
+);</pre>
+
+<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>
@@ -154,14 +159,15 @@ name="make_lock"
 name="make_shared_lock"
 >make_shared_lock</a></h3>
 
-<pre>    my $retval = $lock_factory-&#62;make_shared_lock(
-        name     =&#62; $name      # required
-        timeout  =&#62; $timeout   # default: 0
-        interval =&#62; $interval  # default: 100
-    );</pre>
+<pre>my $retval = $lock_factory-&#62;make_shared_lock(
+    name     =&#62; $name      # required
+    timeout  =&#62; $timeout   # default: 0
+    interval =&#62; $interval  # default: 100
+);</pre>
 
 <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"
+>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>

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 13:44:48 2016
@@ -81,19 +81,20 @@ name="NAME"
 name="SYNOPSIS"
 >SYNOPSIS</a></h2>
 
-<pre>    my $folder = Lucy::Store::RAMFolder-&#62;new;
+<pre>my $folder = Lucy::Store::RAMFolder-&#62;new;
 
-    # or sometimes...
-    my $folder = Lucy::Store::RAMFolder-&#62;new(
-        path =&#62; $relative_path,
-    );</pre>
+# or sometimes...
+my $folder = Lucy::Store::RAMFolder-&#62;new(
+    path =&#62; $relative_path,
+);</pre>
 
 <h2><a class='u'
 name="DESCRIPTION"
 >DESCRIPTION</a></h2>
 
 <p>RAMFolder is an entirely in-memory implementation of <a 
href="../../Lucy/Store/Folder.html" class="podlinkpod"
->Folder</a>, primarily used for testing and development.</p>
+>Folder</a>,
+primarily used for testing and development.</p>
 
 <h2><a class='u'
 name="CONSTRUCTORS"
@@ -103,14 +104,15 @@ name="CONSTRUCTORS"
 name="new"
 >new</a></h3>
 
-<pre>    my $folder = Lucy::Store::RAMFolder-&#62;new(
-        path =&#62; $relative_path,   # default: empty string
-    );</pre>
+<pre>my $folder = Lucy::Store::RAMFolder-&#62;new(
+    path =&#62; $relative_path,   # default: empty string
+);</pre>
 
 <p>Create a new RAMFolder.</p>
 
 <ul>
-<li><b>path</b> - Relative path, used for subfolders.</li>
+<li><b>path</b> - Relative path,
+used for subfolders.</li>
 </ul>
 
 <h2><a class='u'

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 13:44:48 2016
@@ -81,13 +81,14 @@ name="NAME"
 name="SYNOPSIS"
 >SYNOPSIS</a></h2>
 
-<pre>    # See LucyX::Index::ByteBufDocWriter</pre>
+<pre># See LucyX::Index::ByteBufDocWriter</pre>
 
 <h2><a class='u'
 name="DESCRIPTION"
 >DESCRIPTION</a></h2>
 
-<p>This is a proof-of-concept class to demonstrate alternate implementations 
for fetching documents. It is unsupported.</p>
+<p>This is a proof-of-concept class to demonstrate alternate implementations 
for fetching documents.
+It is unsupported.</p>
 
 </div>
 

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 13:44:48 2016
@@ -84,73 +84,76 @@ name="SYNOPSIS"
 <p>Create an <a href="../../Lucy/Plan/Architecture.html" class="podlinkpod"
 >Architecture</a> subclass which overrides register_doc_writer() and 
 >register_doc_reader():</p>
 
-<pre>    package MyArchitecture;
-    use base qw( Lucy::Plan::Architecture );
-    use LucyX::Index::ByteBufDocReader;
-    use LucyX::Index::ByteBufDocWriter;
-
-    sub register_doc_writer {
-        my ( $self, $seg_writer ) = @_; 
-        my $doc_writer = LucyX::Index::ByteBufDocWriter-&#62;new(
-            width      =&#62; 16,
-            field      =&#62; &#39;value&#39;,
-            snapshot   =&#62; $seg_writer-&#62;get_snapshot,
-            segment    =&#62; $seg_writer-&#62;get_segment,
-            polyreader =&#62; $seg_writer-&#62;get_polyreader,
-        );  
-        $seg_writer-&#62;register(
-            api       =&#62; &#34;Lucy::Index::DocReader&#34;,
-            component =&#62; $doc_writer,
-        );  
-        $seg_writer-&#62;add_writer($doc_writer);
-    }
-
-    sub register_doc_reader {
-        my ( $self, $seg_reader ) = @_; 
-        my $doc_reader = LucyX::Index::ByteBufDocReader-&#62;new(
-            width    =&#62; 16,
-            field    =&#62; &#39;value&#39;,
-            schema   =&#62; $seg_reader-&#62;get_schema,
-            folder   =&#62; $seg_reader-&#62;get_folder,
-            segments =&#62; $seg_reader-&#62;get_segments,
-            seg_tick =&#62; $seg_reader-&#62;get_seg_tick,
-            snapshot =&#62; $seg_reader-&#62;get_snapshot,
-        );  
-        $seg_reader-&#62;register(
-            api       =&#62; &#39;Lucy::Index::DocReader&#39;,
-            component =&#62; $doc_reader,
-        );  
-    }
-
-    package MySchema;
-    use base qw( Lucy::Plan::Schema );
-
-    sub architecture { MyArchitecture-&#62;new }</pre>
-
-<p>Proceed as normal in your indexer app, making sure that every supplied 
document supplies a valid value for the field in question:</p>
-
-<pre>    $indexer-&#62;add_doc({
-        title   =&#62; $title,
-        content =&#62; $content,
-        id      =&#62; $id,      # &#60;---- Must meet spec.
-    });</pre>
-
-<p>Then, in your search app:</p>
-
-<pre>    my $searcher = Lucy::Search::IndexSearcher-&#62;new( 
-        index =&#62; &#39;/path/to/index&#39;,
-    );
-    my $hits = $searcher-&#62;hits( query =&#62; $query );
-    while ( my $id = $hits-&#62;next ) {
-        my $real_doc = $external_document_source-&#62;fetch( $doc-&#62;{value} 
);
-        ...
-    }</pre>
+<pre>package MyArchitecture;
+use base qw( Lucy::Plan::Architecture );
+use LucyX::Index::ByteBufDocReader;
+use LucyX::Index::ByteBufDocWriter;
+
+sub register_doc_writer {
+    my ( $self, $seg_writer ) = @_; 
+    my $doc_writer = LucyX::Index::ByteBufDocWriter-&#62;new(
+        width      =&#62; 16,
+        field      =&#62; &#39;value&#39;,
+        snapshot   =&#62; $seg_writer-&#62;get_snapshot,
+        segment    =&#62; $seg_writer-&#62;get_segment,
+        polyreader =&#62; $seg_writer-&#62;get_polyreader,
+    );  
+    $seg_writer-&#62;register(
+        api       =&#62; &#34;Lucy::Index::DocReader&#34;,
+        component =&#62; $doc_writer,
+    );  
+    $seg_writer-&#62;add_writer($doc_writer);
+}
+
+sub register_doc_reader {
+    my ( $self, $seg_reader ) = @_; 
+    my $doc_reader = LucyX::Index::ByteBufDocReader-&#62;new(
+        width    =&#62; 16,
+        field    =&#62; &#39;value&#39;,
+        schema   =&#62; $seg_reader-&#62;get_schema,
+        folder   =&#62; $seg_reader-&#62;get_folder,
+        segments =&#62; $seg_reader-&#62;get_segments,
+        seg_tick =&#62; $seg_reader-&#62;get_seg_tick,
+        snapshot =&#62; $seg_reader-&#62;get_snapshot,
+    );  
+    $seg_reader-&#62;register(
+        api       =&#62; &#39;Lucy::Index::DocReader&#39;,
+        component =&#62; $doc_reader,
+    );  
+}
+
+package MySchema;
+use base qw( Lucy::Plan::Schema );
+
+sub architecture { MyArchitecture-&#62;new }</pre>
+
+<p>Proceed as normal in your indexer app,
+making sure that every supplied document supplies a valid value for the field 
in question:</p>
+
+<pre>$indexer-&#62;add_doc({
+    title   =&#62; $title,
+    content =&#62; $content,
+    id      =&#62; $id,      # &#60;---- Must meet spec.
+});</pre>
+
+<p>Then,
+in your search app:</p>
+
+<pre>my $searcher = Lucy::Search::IndexSearcher-&#62;new( 
+    index =&#62; &#39;/path/to/index&#39;,
+);
+my $hits = $searcher-&#62;hits( query =&#62; $query );
+while ( my $id = $hits-&#62;next ) {
+    my $real_doc = $external_document_source-&#62;fetch( $doc-&#62;{value} );
+    ...
+}</pre>
 
 <h2><a class='u'
 name="DESCRIPTION"
 >DESCRIPTION</a></h2>
 
-<p>This is a proof-of-concept class to demonstrate alternate implementations 
for fetching documents. It is unsupported.</p>
+<p>This is a proof-of-concept class to demonstrate alternate implementations 
for fetching documents.
+It is unsupported.</p>
 
 </div>
 

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 13:44:48 2016
@@ -81,10 +81,10 @@ name="NAME"
 name="SYNOPSIS"
 >SYNOPSIS</a></h2>
 
-<pre>    package MySchema::body;
-    use base qw( Lucy::Plan::FullTextType );
-    use LucyX::Index::LongFieldSim;
-    sub make_similarity { LucyX::Index::LongFieldSim-&#62;new }</pre>
+<pre>package MySchema::body;
+use base qw( Lucy::Plan::FullTextType );
+use LucyX::Index::LongFieldSim;
+sub make_similarity { LucyX::Index::LongFieldSim-&#62;new }</pre>
 
 <h2><a class='u'
 name="DESCRIPTION"
@@ -93,35 +93,38 @@ name="DESCRIPTION"
 <p>Apache Lucy&#39;s default <a href="../../Lucy/Index/Similarity.html" 
class="podlinkpod"
 >Similarity</a> implmentation produces a bias towards extremely short 
 >fields.</p>
 
-<pre>    Lucy::Index::Similarity
+<pre>Lucy::Index::Similarity
 
-    | more weight
-    | *
-    |  **  
-    |    ***
-    |       **********
-    |                 ********************
-    |                                     *******************************
-    | less weight                                                        ****
-    |------------------------------------------------------------------------
-      fewer tokens                                              more 
tokens</pre>
+| more weight
+| *
+|  **  
+|    ***
+|       **********
+|                 ********************
+|                                     *******************************
+| less weight                                                        ****
+|------------------------------------------------------------------------
+  fewer tokens                                              more tokens</pre>
 
 <p>LongFieldSim eliminates this bias.</p>
 
-<pre>    LucyX::Index::LongFieldSim
+<pre>LucyX::Index::LongFieldSim
 
-    | more weight
-    | 
-    |    
-    |    
-    |*****************
-    |                 ********************
-    |                                     *******************************
-    | less weight                                                        ****
-    |------------------------------------------------------------------------
-      fewer tokens                                              more 
tokens</pre>
-
-<p>In most cases, the default bias towards short fields is desirable. For 
instance, say you have two documents:</p>
+| more weight
+| 
+|    
+|    
+|*****************
+|                 ********************
+|                                     *******************************
+| less weight                                                        ****
+|------------------------------------------------------------------------
+  fewer tokens                                              more tokens</pre>
+
+<p>In most cases,
+the default bias towards short fields is desirable.
+For instance,
+say you have two documents:</p>
 
 <ul>
 <li>&#34;George Washington&#34;</li>
@@ -129,17 +132,31 @@ name="DESCRIPTION"
 <li>&#34;George Washington Carver&#34;</li>
 </ul>
 
-<p>If a user searches for &#34;george washington&#34;, we want the exact title 
match to appear first. Under the default Similarity implementation it will, 
because the &#34;Carver&#34; in &#34;George Washington Carver&#34; dilutes the 
impact of the other two tokens.</p>
-
-<p>However, under LongFieldSim, the two titles will yield equal scores. That 
would be bad in this particular case, but it could be good in another.</p>
-
-<pre>     &#34;George Washington Carver is cool.&#34;
-
-     &#34;George Washington Carver was born on the eve of the US Civil War, in
-     1864.  His exact date of birth is unknown... Carver&#39;s research in crop
-     rotation revolutionized agriculture...&#34;</pre>
-
-<p>The first document is succinct, but useless. Unfortunately, the default 
similarity will assess it as extremely relevant to a query of &#34;george 
washington carver&#34;. However, under LongFieldSim, the short-field bias is 
eliminated, and the addition of other mentions of Carver&#39;s name in the 
second document yield a higher score and a higher rank.</p>
+<p>If a user searches for &#34;george washington&#34;,
+we want the exact title match to appear first.
+Under the default Similarity implementation it will,
+because the &#34;Carver&#34; in &#34;George Washington Carver&#34; dilutes the 
impact of the other two tokens.</p>
+
+<p>However,
+under LongFieldSim,
+the two titles will yield equal scores.
+That would be bad in this particular case,
+but it could be good in another.</p>
+
+<pre> &#34;George Washington Carver is cool.&#34;
+
+ &#34;George Washington Carver was born on the eve of the US Civil War, in
+ 1864.  His exact date of birth is unknown... Carver&#39;s research in crop
+ rotation revolutionized agriculture...&#34;</pre>
+
+<p>The first document is succinct,
+but useless.
+Unfortunately,
+the default similarity will assess it as extremely relevant to a query of 
&#34;george washington carver&#34;.
+However,
+under LongFieldSim,
+the short-field bias is eliminated,
+and the addition of other mentions of Carver&#39;s name in the second document 
yield a higher score and a higher rank.</p>
 
 </div>
 

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 13:44:48 2016
@@ -81,21 +81,22 @@ name="NAME"
 name="SYNOPSIS"
 >SYNOPSIS</a></h2>
 
-<pre>    my $searcher = eval {
-        LucyX::Remote::ClusterSearcher-&#62;new(
-            schema =&#62; MySchema-&#62;new,
-            shards =&#62; [ &#39;search1:7890&#39;, &#39;search2:7890&#39;, 
&#39;search3:7890&#39; ],
-        );
-    };
-    ...
-    my $hits = eval { $searcher-&#62;hits( query =&#62; $query ) };</pre>
+<pre>my $searcher = eval {
+    LucyX::Remote::ClusterSearcher-&#62;new(
+        schema =&#62; MySchema-&#62;new,
+        shards =&#62; [ &#39;search1:7890&#39;, &#39;search2:7890&#39;, 
&#39;search3:7890&#39; ],
+    );
+};
+...
+my $hits = eval { $searcher-&#62;hits( query =&#62; $query ) };</pre>
 
 <h2><a class='u'
 name="DESCRIPTION"
 >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"
+>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>
 
 <h2><a class='u'
@@ -106,12 +107,15 @@ name="METHODS"
 name="new"
 >new</a></h3>
 
-<p>Constructor. Takes hash-style params.</p>
+<p>Constructor.
+Takes hash-style params.</p>
 
 <ul>
-<li><b>schema</b> - A Schema, which must match the Schema used by each remote 
node.</li>
+<li><b>schema</b> - A Schema,
+which must match the Schema used by each remote node.</li>
 
-<li><b>shards</b> - An array of host:port pairs running 
LucyX::Remote::SearchServer instances, which identifying the shards that make 
up the composite index.</li>
+<li><b>shards</b> - An array of host:port pairs running 
LucyX::Remote::SearchServer instances,
+which identifying the shards that make up the composite index.</li>
 </ul>
 
 </div>

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 13:44:48 2016
@@ -85,10 +85,10 @@ name="NAME"
 name="SYNOPSIS"
 >SYNOPSIS</a></h2>
 
-<pre>    my $client = LucyX::Remote::SearchClient-&#62;new(
-        peer_address =&#62; &#39;searchserver1:7890&#39;,
-    );
-    my $hits = $client-&#62;hits( query =&#62; $query );</pre>
+<pre>my $client = LucyX::Remote::SearchClient-&#62;new(
+    peer_address =&#62; &#39;searchserver1:7890&#39;,
+);
+my $hits = $client-&#62;hits( query =&#62; $query );</pre>
 
 <h2><a class='u'
 name="DESCRIPTION"
@@ -106,7 +106,8 @@ name="METHODS"
 name="new"
 >new</a></h3>
 
-<p>Constructor. Takes hash-style params.</p>
+<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>

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 13:44:48 2016
@@ -81,25 +81,30 @@ name="NAME"
 name="SYNOPSIS"
 >SYNOPSIS</a></h2>
 
-<pre>    my $searcher = Lucy::Search::IndexSearcher-&#62;new( 
-        index =&#62; &#39;/path/to/index&#39; 
-    );
-    my $search_server = LucyX::Remote::SearchServer-&#62;new(
-        searcher =&#62; $searcher
-    );
-    $search_server-&#62;serve(
-        port =&#62; 7890
-    );</pre>
+<pre>my $searcher = Lucy::Search::IndexSearcher-&#62;new( 
+    index =&#62; &#39;/path/to/index&#39; 
+);
+my $search_server = LucyX::Remote::SearchServer-&#62;new(
+    searcher =&#62; $searcher
+);
+$search_server-&#62;serve(
+    port =&#62; 7890
+);</pre>
 
 <h2><a class='u'
 name="DESCRIPTION"
 >DESCRIPTION</a></h2>
 
-<p>The SearchServer class, in conjunction with either <a 
href="../../LucyX/Remote/SearchClient.html" class="podlinkpod"
+<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"
->ClusterSearcher</a>, makes it possible to run a search on one machine and 
report results on another.</p>
+>ClusterSearcher</a>,
+makes it possible to run a search on one machine and report results on 
another.</p>
 
-<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>
+<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>
 
 <h2><a class='u'
 name="METHODS"
@@ -109,11 +114,12 @@ name="METHODS"
 name="new"
 >new</a></h3>
 
-<pre>    my $search_server = LucyX::Remote::SearchServer-&#62;new(
-        searcher =&#62; $searcher, # required
-    );</pre>
+<pre>my $search_server = LucyX::Remote::SearchServer-&#62;new(
+    searcher =&#62; $searcher, # required
+);</pre>
 
-<p>Constructor. Takes hash-style parameters.</p>
+<p>Constructor.
+Takes hash-style parameters.</p>
 
 <ul>
 <li><b>searcher</b> - the <a href="../../Lucy/Search/IndexSearcher.html" 
class="podlinkpod"
@@ -124,9 +130,9 @@ name="new"
 name="serve"
 >serve</a></h3>
 
-<pre>    $search_server-&#62;serve(
-        port =&#62; 7890,      # required
-    );</pre>
+<pre>$search_server-&#62;serve(
+    port =&#62; 7890,      # required
+);</pre>
 
 <p>Open a listening socket on localhost and wait for SearchClients to 
connect.</p>
 
@@ -138,9 +144,12 @@ name="serve"
 name="serve_rpc"
 >serve_rpc</a></h3>
 
-<pre>    my $status = $search_server-&#62;serve_rpc($sock);</pre>
+<pre>my $status = $search_server-&#62;serve_rpc($sock);</pre>
 
-<p>Handle a single RPC from socket $sock. Returns &#39;done&#39; if the 
connection should be closed. Returns &#39;terminate&#39; if the server should 
shut down. Returns &#39;continue&#39; if the server should continue to handle 
requests from this client.</p>
+<p>Handle a single RPC from socket $sock.
+Returns &#39;done&#39; if the connection should be closed.
+Returns &#39;terminate&#39; if the server should shut down.
+Returns &#39;continue&#39; if the server should continue to handle requests 
from this client.</p>
 
 </div>
 

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 13:44:48 2016
@@ -81,40 +81,44 @@ name="NAME"
 name="SYNOPSIS"
 >SYNOPSIS</a></h2>
 
-<pre>    my %category_filters;
-    for my $category (qw( sweet sour salty bitter )) {
-        my $cat_query = Lucy::Search::TermQuery-&#62;new(
-            field =&#62; &#39;category&#39;,
-            term  =&#62; $category,
-        );
-        $category_filters{$category} = LucyX::Search::Filter-&#62;new( 
-            query =&#62; $cat_query, 
-        );
-    }
-
-    while ( my $cgi = CGI::Fast-&#62;new ) {
-        my $user_query = $cgi-&#62;param(&#39;q&#39;);
-        my $filter     = $category_filters{ 
$cgi-&#62;param(&#39;category&#39;) };
-        my $and_query  = Lucy::Search::ANDQuery-&#62;new;
-        $and_query-&#62;add_child($user_query);
-        $and_query-&#62;add_child($filter);
-        my $hits = $searcher-&#62;hits( query =&#62; $and_query );
-        ...</pre>
+<pre>my %category_filters;
+for my $category (qw( sweet sour salty bitter )) {
+    my $cat_query = Lucy::Search::TermQuery-&#62;new(
+        field =&#62; &#39;category&#39;,
+        term  =&#62; $category,
+    );
+    $category_filters{$category} = LucyX::Search::Filter-&#62;new( 
+        query =&#62; $cat_query, 
+    );
+}
+
+while ( my $cgi = CGI::Fast-&#62;new ) {
+    my $user_query = $cgi-&#62;param(&#39;q&#39;);
+    my $filter     = $category_filters{ $cgi-&#62;param(&#39;category&#39;) };
+    my $and_query  = Lucy::Search::ANDQuery-&#62;new;
+    $and_query-&#62;add_child($user_query);
+    $and_query-&#62;add_child($filter);
+    my $hits = $searcher-&#62;hits( query =&#62; $and_query );
+    ...</pre>
 
 <h2><a class='u'
 name="DESCRIPTION"
 >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>
+>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>
 
 <ul>
 <li>A Filter does not contribute to the score of the documents it matches.</li>
 
-<li>A Filter caches its results, so it is more efficient if you use it more 
than once.</li>
+<li>A Filter caches its results,
+so it is more efficient if you use it more than once.</li>
 </ul>
 
-<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>
+<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>
 
 <h2><a class='u'
 name="METHODS"
@@ -124,11 +128,14 @@ name="METHODS"
 name="new"
 >new</a></h3>
 
-<pre>    my $filter = LucyX::Search::Filter-&#62;new(
-        query =&#62; $query;
-    );</pre>
-
-<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"
+<pre>my $filter = LucyX::Search::Filter-&#62;new(
+    query =&#62; $query;
+);</pre>
+
+<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>
 
 <h2><a class='u'

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 13:44:48 2016
@@ -81,12 +81,12 @@ name="NAME"
 name="SYNOPSIS"
 >SYNOPSIS</a></h2>
 
-<pre>    my $proximity_query = LucyX::Search::ProximityQuery-&#62;new( 
-        field  =&#62; &#39;content&#39;,
-        terms  =&#62; [qw( the who )],
-        within =&#62; 10,    # match within 10 positions
-    );
-    my $hits = $searcher-&#62;hits( query =&#62; $proximity_query );</pre>
+<pre>my $proximity_query = LucyX::Search::ProximityQuery-&#62;new( 
+    field  =&#62; &#39;content&#39;,
+    terms  =&#62; [qw( the who )],
+    within =&#62; 10,    # match within 10 positions
+);
+my $hits = $searcher-&#62;hits( query =&#62; $proximity_query );</pre>
 
 <h2><a class='u'
 name="DESCRIPTION"
@@ -103,11 +103,11 @@ name="CONSTRUCTORS"
 name="new"
 >new</a></h3>
 
-<pre>    my $proximity_query = LucyX::Search::ProximityQuery-&#62;new(
-        field  =&#62; $field   # required
-        terms  =&#62; $terms   # required
-        within =&#62; $within  # required
-    );</pre>
+<pre>my $proximity_query = LucyX::Search::ProximityQuery-&#62;new(
+    field  =&#62; $field   # required
+    terms  =&#62; $terms   # required
+    within =&#62; $within  # required
+);</pre>
 
 <p>Create a new ProximityQuery.</p>
 
@@ -125,7 +125,7 @@ name="METHODS"
 name="get_field"
 >get_field</a></h3>
 
-<pre>    my $retval = $proximity_query-&#62;get_field();</pre>
+<pre>my $retval = $proximity_query-&#62;get_field();</pre>
 
 <p>Accessor for object&#8217;s field attribute.</p>
 
@@ -133,7 +133,7 @@ name="get_field"
 name="get_terms"
 >get_terms</a></h3>
 
-<pre>    my $retval = $proximity_query-&#62;get_terms();</pre>
+<pre>my $retval = $proximity_query-&#62;get_terms();</pre>
 
 <p>Accessor for object&#8217;s array of terms.</p>
 
@@ -141,7 +141,7 @@ name="get_terms"
 name="get_within"
 >get_within</a></h3>
 
-<pre>    my $retval = $proximity_query-&#62;get_within();</pre>
+<pre>my $retval = $proximity_query-&#62;get_within();</pre>
 
 <p>Accessor for object&#8217;s within attribute.</p>
 
@@ -149,11 +149,11 @@ name="get_within"
 name="make_compiler"
 >make_compiler</a></h3>
 
-<pre>    my $retval = $proximity_query-&#62;make_compiler(
-        searcher    =&#62; $searcher     # required
-        boost       =&#62; $boost        # required
-        subordinate =&#62; $subordinate  # default: false
-    );</pre>
+<pre>my $retval = $proximity_query-&#62;make_compiler(
+    searcher    =&#62; $searcher     # required
+    boost       =&#62; $boost        # required
+    subordinate =&#62; $subordinate  # default: false
+);</pre>
 
 <p>Abstract factory method returning a Compiler derived from this Query.</p>
 
@@ -162,7 +162,9 @@ name="make_compiler"
 
 <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"
+<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>
 



Reply via email to