|
a/src/README |
|
b/src/README |
|
... |
|
... |
6 |
|
6 |
|
7 |
Jean-Francois Dockes
|
7 |
Jean-Francois Dockes
|
8 |
|
8 |
|
9 |
<jfd@recoll.org>
|
9 |
<jfd@recoll.org>
|
10 |
|
10 |
|
11 |
Copyright (c) 2005 Jean-Francois Dockes
|
11 |
Copyright (c) 2005-2011 Jean-Francois Dockes
|
12 |
|
12 |
|
13 |
This document introduces full text search notions and describes the
|
13 |
This document introduces full text search notions and describes the
|
14 |
installation and use of the Recoll application. It currently describes
|
14 |
installation and use of the Recoll application. It currently describes
|
15 |
Recoll 1.15.
|
15 |
Recoll 1.15.
|
16 |
|
16 |
|
|
... |
|
... |
44 |
|
44 |
|
45 |
2.4. Using Beagle WEB browser plugins
|
45 |
2.4. Using Beagle WEB browser plugins
|
46 |
|
46 |
|
47 |
2.5. Periodic indexing
|
47 |
2.5. Periodic indexing
|
48 |
|
48 |
|
49 |
2.5.1. Starting indexing
|
49 |
2.5.1. Running indexing
|
50 |
|
50 |
|
51 |
2.5.2. Using cron to automate indexing
|
51 |
2.5.2. Using cron to automate indexing
|
52 |
|
52 |
|
53 |
2.6. Real time indexing
|
53 |
2.6. Real time indexing
|
54 |
|
54 |
|
|
... |
|
... |
493 |
|
493 |
|
494 |
----------------------------------------------------------------------
|
494 |
----------------------------------------------------------------------
|
495 |
|
495 |
|
496 |
2.5. Periodic indexing
|
496 |
2.5. Periodic indexing
|
497 |
|
497 |
|
498 |
2.5.1. Starting indexing
|
498 |
2.5.1. Running indexing
|
499 |
|
499 |
|
500 |
Indexing is performed either by the recollindex program, or by the
|
500 |
Indexing is performed either by the recollindex program, or by the
|
501 |
indexing thread inside the recoll program (use the File menu). Both
|
501 |
indexing thread inside the recoll program (use the File menu). Both
|
502 |
programs will use the RECOLL_CONFDIR variable or accept a -c confdir
|
502 |
programs will use the RECOLL_CONFDIR variable or accept a -c confdir
|
503 |
option to specify a non-default configuration directory.
|
503 |
option to specify a non-default configuration directory.
|
|
... |
|
... |
537 |
but files that were indexed up to the interruption and are still up to
|
537 |
but files that were indexed up to the interruption and are still up to
|
538 |
date will not need to be reindexed).
|
538 |
date will not need to be reindexed).
|
539 |
|
539 |
|
540 |
recollindex has a number of other options which are described in its man
|
540 |
recollindex has a number of other options which are described in its man
|
541 |
page.
|
541 |
page.
|
|
|
542 |
|
|
|
543 |
Of special interest maybe are the -i and -f options. -i allows indexing an
|
|
|
544 |
explicit list of files (given as command line parameters or read on
|
|
|
545 |
stdin). -f tells recollindex to ignore file selection parameters from the
|
|
|
546 |
configuration. Together, these options allow building a custom file
|
|
|
547 |
selection process for some area of the file system, by adding the top
|
|
|
548 |
directory to the skippedPaths list and using an appropriate file selection
|
|
|
549 |
method to build the file list to be fed to recollindex -if .
|
|
|
550 |
|
|
|
551 |
recollindex -i will not descend into directory parameters, but just add
|
|
|
552 |
them as index entries. It is up to the external file selection method to
|
|
|
553 |
build the complete file list.
|
542 |
|
554 |
|
543 |
----------------------------------------------------------------------
|
555 |
----------------------------------------------------------------------
|
544 |
|
556 |
|
545 |
2.5.2. Using cron to automate indexing
|
557 |
2.5.2. Using cron to automate indexing
|
546 |
|
558 |
|
|
... |
|
... |
1567 |
|
1579 |
|
1568 |
The field syntax also supports a few field-like, but special, criteria:
|
1580 |
The field syntax also supports a few field-like, but special, criteria:
|
1569 |
|
1581 |
|
1570 |
* dir for filtering the results on file location (Ex:
|
1582 |
* dir for filtering the results on file location (Ex:
|
1571 |
dir:/home/me/somedir). -dir also works to find results out of the
|
1583 |
dir:/home/me/somedir). -dir also works to find results out of the
|
1572 |
specified directory, only after release 1.16.
|
1584 |
specified directory, only after release 1.15.8.
|
1573 |
|
1585 |
|
1574 |
* date for searching or filtering on dates. The syntax for the argument
|
1586 |
* date for searching or filtering on dates. The syntax for the argument
|
1575 |
is based on the ISO8601 standard for dates and time intervals. Only
|
1587 |
is based on the ISO8601 standard for dates and time intervals. Only
|
1576 |
dates are supported, no times. The general syntax is 2 elements
|
1588 |
dates are supported, no times. The general syntax is 2 elements
|
1577 |
separated by a / character. Each element can be a date or a period of
|
1589 |
separated by a / character. Each element can be a date or a period of
|
|
... |
|
... |
1598 |
Periods can also be specified with small letters (ie: p2y).
|
1610 |
Periods can also be specified with small letters (ie: p2y).
|
1599 |
|
1611 |
|
1600 |
* mime or format for specifying the mime type. This one is quite special
|
1612 |
* mime or format for specifying the mime type. This one is quite special
|
1601 |
because you can specify several values which will be OR'ed (the normal
|
1613 |
because you can specify several values which will be OR'ed (the normal
|
1602 |
default for the language is AND). Ex: mime:text/plain mime:text/html.
|
1614 |
default for the language is AND). Ex: mime:text/plain mime:text/html.
|
1603 |
Specifying an explicit boolean operator or negation (-) before a mime
|
1615 |
Specifying an explicit boolean operator before a mime specification is
|
1604 |
specification is not supported and will produce strange results. Note
|
1616 |
not supported and will produce strange results. You can filter out
|
1605 |
that mime is the ONLY field with an OR default. You do need to use OR
|
1617 |
certain types by using negation (-mime:some/type), and you can use
|
1606 |
with ext terms for example.
|
1618 |
wildcards in the value (mime:text/*). Note that mime is the ONLY field
|
|
|
1619 |
with an OR default. You do need to use OR with ext terms for example.
|
1607 |
|
1620 |
|
1608 |
* type or rclcat for specifying the category (as in
|
1621 |
* type or rclcat for specifying the category (as in
|
1609 |
text/media/presentation/etc.). The classification of mime types in
|
1622 |
text/media/presentation/etc.). The classification of mime types in
|
1610 |
categories is defined in the Recoll configuration (mimeconf), and can
|
1623 |
categories is defined in the Recoll configuration (mimeconf), and can
|
1611 |
be modified or extended. The default category names are those which
|
1624 |
be modified or extended. The default category names are those which
|