|
a/src/INSTALL |
|
b/src/INSTALL |
|
... |
|
... |
| 176 |
Recoll has been built on Linux, FreeBSD, macosx, and Solaris, most
|
176 |
Recoll has been built on Linux, FreeBSD, macosx, and Solaris, most
|
| 177 |
versions after 2005 should be ok, maybe some older ones too (Solaris 8 is
|
177 |
versions after 2005 should be ok, maybe some older ones too (Solaris 8 is
|
| 178 |
ok). If you build on another system, and need to modify things, I would
|
178 |
ok). If you build on another system, and need to modify things, I would
|
| 179 |
very much welcome patches.
|
179 |
very much welcome patches.
|
| 180 |
|
180 |
|
| 181 |
Depending on the qt configuration on your system, you may have to set the
|
181 |
Depending on the Qt 3 configuration on your system, you may have to set
|
| 182 |
QTDIR and QMAKESPECS variables in your environment:
|
182 |
the QTDIR and QMAKESPECS variables in your environment:
|
| 183 |
|
183 |
|
| 184 |
* QTDIR should point to the directory above the one that holds the qt
|
184 |
* QTDIR should point to the directory above the one that holds the qt
|
| 185 |
include files (ie: if qt.h is /usr/local/qt/include/qt.h, QTDIR should
|
185 |
include files (ie: if qt.h is /usr/local/qt/include/qt.h, QTDIR should
|
| 186 |
be /usr/local/qt).
|
186 |
be /usr/local/qt).
|
| 187 |
|
187 |
|
| 188 |
* QMAKESPECS should be set to the name of one of the qt mkspecs
|
188 |
* QMAKESPECS should be set to the name of one of the qt mkspecs
|
| 189 |
sub-directories (ie: linux-g++).
|
189 |
sub-directories (ie: linux-g++).
|
| 190 |
|
190 |
|
| 191 |
On many Linux systems, QTDIR is set by the login scripts, and QMAKESPECS
|
191 |
On many Linux systems, QTDIR is set by the login scripts, and QMAKESPECS
|
| 192 |
is not needed because there is a default link in mkspecs/. Neither should
|
192 |
is not needed because there is a default link in mkspecs/.
|
| 193 |
be needed with Qt 4.
|
193 |
|
|
|
194 |
Neither QTDIR nor QMAKESPECS should be needed with Qt 4, configuration
|
|
|
195 |
details are entirely determined by qmake (which is quite often installed
|
|
|
196 |
as qmake-qt4).
|
| 194 |
|
197 |
|
| 195 |
Configure options:
|
198 |
Configure options:
|
| 196 |
|
199 |
|
| 197 |
* --without-aspell will disable the code for phonetic matching of search
|
200 |
* --without-aspell will disable the code for phonetic matching of search
|
| 198 |
terms.
|
201 |
terms.
|
|
... |
|
... |
| 217 |
the gnu version on systems where the native one is bad.
|
220 |
the gnu version on systems where the native one is bad.
|
| 218 |
|
221 |
|
| 219 |
* --without-gui Disable the Qt interface, and auxiliary uses of X11, and
|
222 |
* --without-gui Disable the Qt interface, and auxiliary uses of X11, and
|
| 220 |
compile the command line version.
|
223 |
compile the command line version.
|
| 221 |
|
224 |
|
|
|
225 |
* Of course the usual autoconf configure options, like --prefix apply.
|
|
|
226 |
|
| 222 |
Normal procedure:
|
227 |
Normal procedure:
|
| 223 |
|
228 |
|
| 224 |
cd recoll-xxx
|
229 |
cd recoll-xxx
|
| 225 |
configure
|
230 |
configure
|
| 226 |
make
|
231 |
make
|
|
... |
|
... |
| 237 |
|
242 |
|
| 238 |
Either type make install or execute recollinstall prefix, in the root of
|
243 |
Either type make install or execute recollinstall prefix, in the root of
|
| 239 |
the source tree. This will copy the commands to prefix/bin and the sample
|
244 |
the source tree. This will copy the commands to prefix/bin and the sample
|
| 240 |
configuration files, scripts and other shared data to prefix/share/recoll.
|
245 |
configuration files, scripts and other shared data to prefix/share/recoll.
|
| 241 |
|
246 |
|
| 242 |
If the installation prefix given to recollinstall is different from what
|
247 |
If the installation prefix given to recollinstall is different from either
|
| 243 |
was specified when executing configure, you will have to set the
|
248 |
the system default or the value which was specified when executing
|
|
|
249 |
configure (as in configure --prefix /some/path), you will have to set the
|
| 244 |
RECOLL_DATADIR environment variable to indicate where the shared data is
|
250 |
RECOLL_DATADIR environment variable to indicate where the shared data is
|
| 245 |
to be found.
|
251 |
to be found (ie for (ba)sh: export
|
|
|
252 |
RECOLL_DATADIR=/some/path/share/recoll).
|
| 246 |
|
253 |
|
| 247 |
You can then proceed to configuration.
|
254 |
You can then proceed to configuration.
|
| 248 |
|
255 |
|
| 249 |
--------------------------------------------------------------------------
|
256 |
--------------------------------------------------------------------------
|
| 250 |
|
257 |
|
|
... |
|
... |
| 316 |
|
323 |
|
| 317 |
* Parameter affectation (name = value).
|
324 |
* Parameter affectation (name = value).
|
| 318 |
|
325 |
|
| 319 |
* Section definition ([somedirname]).
|
326 |
* Section definition ([somedirname]).
|
| 320 |
|
327 |
|
| 321 |
Section definitions allow redefining some parameters for a directory
|
328 |
Depending on the type of configuration file, section definitions either
|
|
|
329 |
separate groups of parameters or allow redefining some parameters for a
|
| 322 |
sub-tree. They stay in effect until another section definition, or the end
|
330 |
directory sub-tree. They stay in effect until another section definition,
|
| 323 |
of file, is encountered. Some of the parameters used for indexing are
|
331 |
or the end of file, is encountered. Some of the parameters used for
|
| 324 |
looked up hierarchically from the current directory location upwards. Not
|
332 |
indexing are looked up hierarchically from the current directory location
|
| 325 |
all parameters can be meaningfully redefined, this is specified for each
|
333 |
upwards. Not all parameters can be meaningfully redefined, this is
|
| 326 |
in the next section.
|
334 |
specified for each in the next section.
|
| 327 |
|
335 |
|
| 328 |
When found at the beginning of a file path, the tilde character (~) is
|
336 |
When found at the beginning of a file path, the tilde character (~) is
|
| 329 |
expanded to the name of the user's home directory, as a shell would do.
|
337 |
expanded to the name of the user's home directory, as a shell would do.
|
| 330 |
|
338 |
|
| 331 |
White space is used for separation inside lists. List elements with
|
339 |
White space is used for separation inside lists. List elements with
|