*** empty log message ***

This commit is contained in:
dockes 2007-05-30 12:30:55 +00:00
parent 4d3b9621b6
commit 441820d1ef

View File

@ -24,7 +24,7 @@
Dockes</holder> Dockes</holder>
</copyright> </copyright>
<releaseinfo>$Id: usermanual.sgml,v 1.42 2007-05-21 07:24:14 dockes Exp $</releaseinfo> <releaseinfo>$Id: usermanual.sgml,v 1.43 2007-05-30 12:30:55 dockes Exp $</releaseinfo>
<abstract> <abstract>
<para>This document introduces full text search notions <para>This document introduces full text search notions
@ -310,6 +310,43 @@ recoll
only contains data that can be completely rebuilt by an index only contains data that can be completely rebuilt by an index
run, and it can always be destroyed safely.</para> run, and it can always be destroyed safely.</para>
<sect2 id="rcl.indexing.storage.format">
<title>Index formats</title>
<para>&XAP; has had two possible index formats for quite some
time. The "old" one named <literal>Quartz</literal>, and the
new one named <literal>Flint</literal>. &XAP; 0.9 used
<literal>Quartz</literal> by default, but could use
<literal>Flint</literal> if a specific environment variable
(<literal>XAPIAN_PREFER_FLINT</literal>) was set. &XAP; 1.0
still supports <literal>Quartz</literal> but will use
<literal>Flint</literal> by default for new index
creations.</para>
<para>The number of disk accesses performed during indexing
has been much optimized in the new <literal>Flint</literal>
engine and you may see indexing times improved by 50% in some
cases (compared to <literal>Quartz</literal>), typically for
big indexes where disk accesses dominate the indexing
time. There is also a more modest improvement of index
size.</para>
<para>&XAP; will not convert automatically an existing index
from the <literal>Quartz</literal> to the
<literal>Flint</literal> format. If you have an older index
and want to take advantage of the new format (which can be
done without setting the environment variable as of &RCL;
1.8.2 and &XAP; 1.0.0), you will have to explicitely delete
the old index, then run a normal indexing process.</para>
<para>Unfortunately, using the <literal>-z</literal> option to
<command>recollindex</command> is not sufficient to change the
format, you have to delete all files inside the index
directory (typically <filename>~/.recoll/xapiandb</filename>)
before starting indexing.</para>
</sect2>
<sect2 id="rcl.indexing.storage.security"> <sect2 id="rcl.indexing.storage.security">
<title>Security aspects</title> <title>Security aspects</title>