Add -c <confdir> option to recoll and recollindex

src/doc/man/recoll.1

@@ -1,9 +1,13 @@
-.\" $Id: recoll.1,v 1.1 2006-01-10 08:14:43 dockes Exp $ (C) 2005 J.F.Dockes\$
+.\" $Id: recoll.1,v 1.2 2006-09-08 09:02:47 dockes Exp $ (C) 2005 J.F.Dockes\$
 .TH RECOLL 1 "8 January 2006"
 .SH NAME
 recoll \- user interface for the Recoll full text search system
 .SH SYNOPSIS
 .B recoll
+[
+.B -c
+<configdir>
+]
 .SH DESCRIPTION
 The
 .B recoll
@@ -16,6 +20,11 @@ On the first run,
 will create the user configuration which can be customized
 before starting the first indexation.
 .PP
+The 
+.B -c 
+option specifies the configuration directory name, overriding the
+default or $RECOLL_CONFDIR.
+.PP
 Please refer to online help for a full description.
 .SH SEE ALSO
 .PP 

src/doc/man/recoll.conf.5

@@ -1,4 +1,4 @@
-.\" $Id: recoll.conf.5,v 1.2 2006-03-28 12:49:03 dockes Exp $ (C) 2005 J.F.Dockes\$
+.\" $Id: recoll.conf.5,v 1.3 2006-09-08 09:02:47 dockes Exp $ (C) 2005 J.F.Dockes\$
 .TH RECOLL.CONF 5 "8 January 2006"
 .SH NAME
 recoll.conf \- main personal configuration file for Recoll
@@ -90,7 +90,8 @@ images.
 .TP
 .BI "dbdir = " directory
 The name of the Xapian database directory. It will be created if needed
-when the database is initialized.
+when the database is initialized. If this is not an absolute pathname, it
+will be taken relative to the configuration directory.
 .TP
 .BI "defaultcharset = " charset
 The name of the character set used for files that do not contain a

src/doc/man/recollindex.1

@@ -1,4 +1,4 @@
-.\" $Id: recollindex.1,v 1.1 2006-01-10 08:09:52 dockes Exp $ (C) 2005 J.F.Dockes\$
+.\" $Id: recollindex.1,v 1.2 2006-09-08 09:02:47 dockes Exp $ (C) 2005 J.F.Dockes\$
 .TH RECOLLINDEX 1 "8 January 2006"
 .SH NAME
 recollindex \- indexing command for the Recoll full text search system
@@ -7,14 +7,26 @@ recollindex \- indexing command for the Recoll full text search system
 .br
 .B recollindex
 [
+.B -c
+<configdir>
+]
+[
 .B -z
 ]
 .br
 .B recollindex 
+[
+.B -c
+<configdir>
+]
 .B -i 
 <filename [filename ...]>
 .br
 .B recollindex
+[
+.B -c
+<configdir>
+]
 .B -s 
 <lang>
 .SH DESCRIPTION
@@ -23,6 +35,11 @@ The
 utility allows you to perform indexing operations for the Recoll text
 search system.
 .PP
+The 
+.B -c 
+option specifies the configuration directory name, overriding the
+default or $RECOLL_CONFDIR.
+.PP
 There are three modes of operation. 
 .PP
 The normal mode will index the set of files described in the configuration

src/doc/user/usermanual.sgml

@@ -24,7 +24,7 @@
       Dockes</holder>
     </copyright>
 
-    <releaseinfo>$Id: usermanual.sgml,v 1.14 2006-06-24 07:40:04 dockes Exp $</releaseinfo>
+    <releaseinfo>$Id: usermanual.sgml,v 1.15 2006-09-08 09:02:47 dockes Exp $</releaseinfo>
 
     <abstract>
       <para>This document introduces full text search notions
@@ -44,7 +44,8 @@
       like to give &RCL; a try, just perform <link
       linkend="rcl.install">installation</link> and start the
       <command>recoll</command> user interface, which will index your
-      home directory and let you search it right after.</para>
+      home directory by default, allowing you to search immediately after
+      indexing completes.</para>
 
       <para>Do not do this if your home has a huge
       number of documents and you do not want to wait or are very
@@ -73,16 +74,15 @@
       <para>You do not need to remember in what file or email message you
         stored a given piece of information. You just ask for related
         terms, and the tool will return a list of documents where
-        those terms are prominent.</para>
+        those terms are prominent, in a similar way to internet search
+        engines.</para>
 
-      <para>This mode of operation has been made very familiar by internet
-       search engines.</para>
-
-      <para>The notion of relevance is a difficult one, as only you, the
-      user, actually know which documents are relevant to your search,
-      and the application can only try a guess. The quality of this
-      guess is probably the most important element for a search
-      application.</para> 
+      <para>&RCL; tries to determine which documents are most relevant to
+      the search terms you provide. Computer algorithms for determining
+      relevance can be very complex, and in general are inferior to the
+      power of the human mind to rapidly determine relevance. The quality
+      of relevance guessing by the search tool is probably the most
+      important element for a search application.</para>
 
       <para>In many cases, you are looking for all the forms of a
         word, not for a specific form or spelling. These different
@@ -93,8 +93,9 @@
         reduce to the same stem). This expansion can be disabled at
         search time.</para>
 
-     <para>Stemming, by itself, does not provide for misspellings or
-        phonetic searches. &RCL; currently does not support these.</para>
+     <para>Stemming, by itself, does not accomodate for misspellings or
+        phonetic searches. &RCL; currently does not support these
+        features.</para> 
 
 
     </sect1>
@@ -914,9 +915,11 @@
       files are kept in a directory named like
       <filename>/usr/[local/]share/recoll/examples</filename>, 
       they define default values for the system. A parallel set of
-      files exists  in the <filename>.recoll</filename> directory in
-      your home (this can be changed with the 
-      <literal>RECOLL_CONFDIR</literal> environment variable.</para>
+      files exists by default in the <filename>.recoll</filename> directory
+      in your home. This directory can be changed with the 
+      <literal>RECOLL_CONFDIR</literal> environment variable or the -c
+      option parameter to <command>recoll</command> and
+      <command>recollindex</command>.</para> 
 
       <para>If the <filename>.recoll</filename> directory does not
       exist when <command>recoll</command> or 
@@ -1080,7 +1083,8 @@
           <varlistentry><term><literal>dbdir</literal></term>
             <listitem><para>The name of the Xapian data directory. It
             will be created if needed when the index is
-            initialized. </para>
+            initialized. If this is not an absolute path, it will be
+            interpreted relative to the configuration directory.</para>
             </listitem>
           </varlistentry>