--- a/src/README
+++ b/src/README
@@ -2106,8 +2106,8 @@
ok). If you build on another system, and need to modify things, I would
very much welcome patches.
- Depending on the qt configuration on your system, you may have to set the
- QTDIR and QMAKESPECS variables in your environment:
+ Depending on the Qt 3 configuration on your system, you may have to set
+ the QTDIR and QMAKESPECS variables in your environment:
* QTDIR should point to the directory above the one that holds the qt
include files (ie: if qt.h is /usr/local/qt/include/qt.h, QTDIR should
@@ -2117,8 +2117,11 @@
sub-directories (ie: linux-g++).
On many Linux systems, QTDIR is set by the login scripts, and QMAKESPECS
- is not needed because there is a default link in mkspecs/. Neither should
- be needed with Qt 4.
+ is not needed because there is a default link in mkspecs/.
+
+ Neither QTDIR nor QMAKESPECS should be needed with Qt 4, configuration
+ details are entirely determined by qmake (which is quite often installed
+ as qmake-qt4).
Configure options:
@@ -2147,6 +2150,8 @@
* --without-gui Disable the Qt interface, and auxiliary uses of X11, and
compile the command line version.
+ * Of course the usual autoconf configure options, like --prefix apply.
+
Normal procedure:
cd recoll-xxx
@@ -2169,10 +2174,12 @@
the source tree. This will copy the commands to prefix/bin and the sample
configuration files, scripts and other shared data to prefix/share/recoll.
- If the installation prefix given to recollinstall is different from what
- was specified when executing configure, you will have to set the
+ If the installation prefix given to recollinstall is different from either
+ the system default or the value which was specified when executing
+ configure (as in configure --prefix /some/path), you will have to set the
RECOLL_DATADIR environment variable to indicate where the shared data is
- to be found.
+ to be found (ie for (ba)sh: export
+ RECOLL_DATADIR=/some/path/share/recoll).
You can then proceed to configuration.
@@ -2236,12 +2243,13 @@
* Section definition ([somedirname]).
- Section definitions allow redefining some parameters for a directory
- sub-tree. They stay in effect until another section definition, or the end
- of file, is encountered. Some of the parameters used for indexing are
- looked up hierarchically from the current directory location upwards. Not
- all parameters can be meaningfully redefined, this is specified for each
- in the next section.
+ Depending on the type of configuration file, section definitions either
+ separate groups of parameters or allow redefining some parameters for a
+ directory sub-tree. They stay in effect until another section definition,
+ or the end of file, is encountered. Some of the parameters used for
+ indexing are looked up hierarchically from the current directory location
+ upwards. Not all parameters can be meaningfully redefined, this is
+ specified for each in the next section.
When found at the beginning of a file path, the tilde character (~) is
expanded to the name of the user's home directory, as a shell would do.