--- a/src/doc/user/usermanual.sgml
+++ b/src/doc/user/usermanual.sgml
@@ -24,7 +24,7 @@
Dockes</holder>
</copyright>
- <releaseinfo>$Id: usermanual.sgml,v 1.3 2006-01-11 15:08:21 dockes Exp $</releaseinfo>
+ <releaseinfo>$Id: usermanual.sgml,v 1.4 2006-01-19 12:01:42 dockes Exp $</releaseinfo>
<abstract>
<para>This document introduces full text search notions
@@ -484,11 +484,40 @@
<title>Building</title>
<para>&RCL; has been built on
- Linux (redhat7.3, mandriva 2005), FreeBSD and Solaris 8. If
- you build on another system, <ulink
- url="mailto:jean-francois.dockes@wanadoo.fr">I would very
- much welcome patches</ulink>.</para>
-
+ Linux (redhat7.3, mandriva 2005, Fedora Core 3), FreeBSD and
+ Solaris 8. If you build on another system, <ulink
+ url="mailto:jean-francois.dockes@wanadoo.fr">I would very much
+ welcome patches</ulink>.</para>
+
+ <para>Depending on the <application>qt</application>
+ configuration on your system, you may have to set the
+ <literal>QTDIR</literal> and <literal>QMAKESPECS</literal>
+ variables in your environment:</para>
+ <itemizedlist>
+ <listitem><para><literal>QTDIR</literal> should point to the
+ directory above the one that holds the qt include files (ie:
+ qt.h).</para>
+ </listitem>
+ <listitem><para><literal>QMAKESPECS</literal> should
+ be set to the name of one of the
+ <application>qt</application> mkspecs subdirectories (ie:
+ linux-g++).</para>
+ </listitem>
+ </itemizedlist>
+
+ <para>On many Linux systems, <literal>QTDIR</literal> is set
+ by the login scripts, and <literal>QMAKESPECS</literal> is not
+ needed because there is a <filename>default</filename> link in
+ <filename>mkspecs/</filename>.</para>
+
+ <para>The &RCL; <command>configure</command> script does a
+ better job of checking these variables after release
+ 1.1.1. Before this, unexplained errors will occur during
+ compilation if the environment is not set up. Also, for 1.1.0 the
+ <command>qmake</command> command should be in your PATH (later
+ releases can also find it in
+ <filename>$QTDIR/bin</filename>).</para>
+
<para>Normal procedure:</para>
<screen>
<userinput>cd recoll-xxx</userinput>
@@ -647,22 +676,38 @@
</varlistentry>
<varlistentry><term><literal>skippedNames</literal></term>
- <listitem><para>A space-separated list of patterns for
- names of files or directories that should be completely
- ignored. The list defined in the default file is:
+ <listitem>
+ <para>A space-separated list of patterns for
+ names of files or directories that should be completely
+ ignored. The list defined in the default file is: </para>
<programlisting>
*~ #* bin CVS Cache caughtspam tmp
</programlisting>
- The list can be redefined for subdirectories, but is only
- actually changed for the top level ones in
- <emphasis>topdirs</emphasis></para>
+ <para>The list can be redefined for subdirectories, but is only
+ actually changed for the top level ones in
+ <literal>topdirs</literal>.</para>
+ <para>The top-level directories are not affected by this
+ list (that is, a directory in <literal>topdirs</literal>
+ might match and would still be indexed).</para>
+ <para>The list in the default configuration does not
+ exclude hidden directories (names beginning with a
+ dot), which means that it may index quite a few things
+ that you do not want. On the other hand, mail user
+ agents like <application>thunderbird</application>
+ usually store messages in hidden directories, and you
+ probably want this indexed. One possible solution is to
+ have <userinput>.*</userinput> in
+ <literal>skippedNames</literal>, and add things like
+ <filename>~/.thunderbird</filename> or
+ <filename>~/.evolution</filename> in
+ <literal>topdirs</literal>.</para>
</listitem>
</varlistentry>
<varlistentry><term><literal>loglevel</literal></term>
<listitem><para>Verbosity level for recoll and
recollindex. A value of 4 lists quite a lot of
- debug/information messages. 3 only lists errors. </para>
+ debug/information messages. 2 only lists errors. </para>
</listitem>
</varlistentry>
@@ -758,6 +803,15 @@
should be handled specially, which is possible because they
are usually all located in one place.</para>
+ <para><filename>mimemap</filename> also has a
+ <literal>recoll_noindex</literal> variable which is a list of
+ suffixes. Matching files will be skipped (avoids unnecessary
+ decompressions or <command>file</command> executions). This is
+ partially redundant with <literal>skippedNames</literal> in
+ the main configuration file, with two differences: it will not
+ affect directories, and it can be changed for any
+ subdirectory.</para>
+
</sect2>
<sect2 id="rclinstall.config.mimeconf">