tris/recoll
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

release 1.15.0

Browse Source
This commit is contained in:
Jean-Francois Dockes 2011-02-02 08:41:43 +01:00
parent 93a761785a
commit 1a08520e65
2 changed files with 128 additions and 60 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
src/INSTALL
View File

@ -161,6 +161,8 @@ More documentation can be found in the doc/ directory or at http://www.recoll.or
* Zip archives need Python (and the standard zipfile module). * Zip archives need Python (and the standard zipfile module).
* Midi karaoke files need Python and the Midi module
Text, HTML, mail folders, and Scribus files are processed internally. Lyx Text, HTML, mail folders, and Scribus files are processed internally. Lyx
is used to index Lyx files. Many filters need iconv and the standard sed is used to index Lyx files. Many filters need iconv and the standard sed
and awk. and awk.

186
src/README
View File

@ -58,24 +58,26 @@ More documentation can be found in the doc/ directory or at http://www.recoll.or
3.1.1. Simple search 3.1.1. Simple search
3.1.2. The result list 3.1.2. The default result list
3.1.3. The preview window 3.1.3. The alternate result table
3.1.4. Complex/advanced search 3.1.4. The preview window
3.1.5. The term explorer tool 3.1.5. Complex/advanced search
3.1.6. Multiple databases 3.1.6. The term explorer tool
3.1.7. Document history 3.1.7. Multiple databases
3.1.8. Sorting search results and collapsing 3.1.8. Document history
3.1.9. Sorting search results and collapsing
duplicates duplicates
3.1.9. Search tips, shortcuts 3.1.10. Search tips, shortcuts
3.1.10. Customizing the search interface 3.1.11. Customizing the search interface
3.2. Searching with the KDE KIO slave 3.2. Searching with the KDE KIO slave
@ -177,19 +179,20 @@ More documentation can be found in the doc/ directory or at http://www.recoll.or
will return a list of documents where those terms are prominent, in a will return a list of documents where those terms are prominent, in a
similar way to Internet search engines. similar way to Internet search engines.
Recoll tries to determine which documents are most relevant to the search A search application tries to determine which documents are most relevant
terms you provide. Computer algorithms for determining relevance can be to the search terms you provide. Computer algorithms for determining
very complex, and in general are inferior to the power of the human mind relevance can be very complex, and in general are inferior to the power of
to rapidly determine relevance. The quality of relevance guessing by the the human mind to rapidly determine relevance. The quality of relevance
search tool is probably the most important element for a search guessing is probably the most important aspect when evaluating a search
application. application.
In many cases, you are looking for all the forms of a word, not for a In many cases, you are looking for all the forms of a word, not for a
specific form or spelling. These different forms may include plurals, specific form or spelling. These different forms may include plurals,
different tenses for a verb, or terms derived from the same root or stem different tenses for a verb, or terms derived from the same root or stem
(example: floor, floors, floored, flooring...). Recoll will by default (example: floor, floors, floored, flooring...). Search applications
expand queries to all such related terms (words that reduce to the same usually expand queries to all such related terms (words that reduce to the
stem). This expansion can be disabled at search time. same stem) and also provide a way to disable this expansion if you are
actually searching for a specific form.
Stemming, by itself, does not accommodate for misspellings or phonetic Stemming, by itself, does not accommodate for misspellings or phonetic
searches. Recoll supports these features through a specific tool (the term searches. Recoll supports these features through a specific tool (the term
@ -202,8 +205,8 @@ More documentation can be found in the doc/ directory or at http://www.recoll.or
Recoll uses the Xapian information retrieval library as its storage and Recoll uses the Xapian information retrieval library as its storage and
retrieval engine. Xapian is a very mature package using a sophisticated retrieval engine. Xapian is a very mature package using a sophisticated
probabilistic ranking model. Recoll provides the interface to get data probabilistic ranking model. Recoll provides the mechanisms and interface
into (indexing) and out (searching) of the system. to get data into and out of the system.
In practice, Xapian works by remembering where terms appear in your In practice, Xapian works by remembering where terms appear in your
document files. The acquisition process is called indexing. document files. The acquisition process is called indexing.
@ -239,8 +242,11 @@ More documentation can be found in the doc/ directory or at http://www.recoll.or
Indexing is started automatically the first time you execute the recoll Indexing is started automatically the first time you execute the recoll
search graphical user interface, or by executing the recollindex command. search graphical user interface, or by executing the recollindex command.
Searches are performed inside the recoll program, which has many options Searches are usually performed inside the recoll graphical user interface
to help you find what you are looking for. (GUI) program, which has many options to help you find what you are
looking for. However, there are other ways to perform Recoll searches:
mostly a command line tool, a Python programming interface, and a KDE KIO
slave module.
---------------------------------------------------------------------- ----------------------------------------------------------------------
@ -263,23 +269,28 @@ More documentation can be found in the doc/ directory or at http://www.recoll.or
* Real time indexing: indexing takes place as soon as a file is created * Real time indexing: indexing takes place as soon as a file is created
or changed. recollindex runs as a daemon and uses a file system or changed. recollindex runs as a daemon and uses a file system
alteration monitor such as Fam, Gamin or inotify do detect file alteration monitor such as inotify, Fam or Gamin to detect file
changes. Monitoring a big directory tree can consume significant changes.
system resources.
The choice between the two methods is mostly a matter of preference, and The choice between the two methods is mostly a matter of preference, and
they can be combined by setting up multiple indexes (ie: use periodic they can be combined by setting up multiple indexes (ie: use periodic
indexing on a big documentation directory, and real time indexing on a indexing on a big documentation directory, and real time indexing on a
small home directory). Monitoring a big file system tree can consume small home directory). Monitoring a big file system tree can consume
significant system resources, for dubious gains. significant system resources.
Recoll knows about quite a few different document types. The parameters Recoll knows about quite a few different document types. The parameters
for document types recognition and processing are set in configuration for document types recognition and processing are set in configuration
files Most file types, like HTML or word processing files, only hold one files.
document. Some file types, like mail folder files, can hold many
individually indexed documents. Most file types, like HTML or word processing files, only hold one
document. Some file types, like mail folder files or zip archives, can
hold many individually indexed documents, which may in turn be themselves
compound ones. Such hierarchies can go quite deep, and Recoll has no
problem processing, for example, an ms-word document which would be an
attachment to an email message part of a folder file archived inside a zip
file...
Recoll indexing processes plain text, HTML, openoffice and e-mail files Recoll indexing processes plain text, HTML, openoffice and e-mail files
internally (a few more actually). internally (a few more actually).
@ -492,16 +503,19 @@ More documentation can be found in the doc/ directory or at http://www.recoll.or
The indexing process can be interrupted by sending an interrupt (^C, The indexing process can be interrupted by sending an interrupt (^C,
SIGINT) or terminate (SIGTERM) signal. Some time may elapse before the SIGINT) or terminate (SIGTERM) signal. Some time may elapse before the
process exits, because it needs to properly flush and close the index. The process exits, because it needs to properly flush and close the index.
indexing will restart at the interruption point the next time (the full
file tree will still be traversed, but files that were indexed up to the
interruption and are still up to date will not need to be reindexed).
After such an interruption, the index will be somewhat inconsistent After such an interruption, the index will be somewhat inconsistent
because some operations which are normally performed at the end of the because some operations which are normally performed at the end of the
indexing pass will have been skipped (for exemple, the stemming and indexing pass will have been skipped (for exemple, the stemming and
spelling databases will be inexistant or out of date). You just need to spelling databases will be inexistant or out of date). You just need to
restart indexing at a later time to restore consistency. restart indexing at a later time to restore consistency. The indexing will
restart at the interruption point (the full file tree will be traversed,
but files that were indexed up to the interruption and are still up to
date will not need to be reindexed).
recollindex has a number of other options which are described in its man
page.
---------------------------------------------------------------------- ----------------------------------------------------------------------
@ -590,7 +604,7 @@ More documentation can be found in the doc/ directory or at http://www.recoll.or
field where you can enter multiple words. field where you can enter multiple words.
* Advanced search (a panel accessed through the Tools menu or the * Advanced search (a panel accessed through the Tools menu or the
toolbox bar icon) shas multiple entry fields, which you may use to toolbox bar icon) has multiple entry fields, which you may use to
build a logical condition, with additional filtering on file type and build a logical condition, with additional filtering on file type and
location in the file system. location in the file system.
@ -618,19 +632,40 @@ More documentation can be found in the doc/ directory or at http://www.recoll.or
4. Click the Search button or hit the Enter key to start the search. 4. Click the Search button or hit the Enter key to start the search.
The initial default search mode is All terms. This will look for documents The initial default search mode is Query language. Without special
containing all of the search terms (the ones with more terms will get directives, this will look for documents containing all of the search
better scores). Any term will search for documents where at least one of terms (the ones with more terms will get better scores), just like the All
the terms appear. terms mode which will ignore such directives. Any term will search for
documents where at least one of the terms appear.
The Query Language features are described in a separate section.
File name will specifically look for file names. The entry will be split File name will specifically look for file names. The entry will be split
at white space characters, and each pattern will be separately expanded. at white space characters, and each fragment will be separately expanded,
If you want to search for a pattern including white space, use double then the search will be for file names matching all fragments (this is new
quotes. The point of having a separate file name search is that wild card in 1.15, older releases did an OR of the whole thing which did not make
expansion can be performed more efficiently on a relatively small subset sense). Things to know:
of the index.
The fourth entry (Query Language) is described in its own section. * The search is case- and accent-insensitive.
* Fragments without any wild card character and not capitalized will be
prepended and appended with '*' (ie: etc -> *etc*, but Etc -> etc). Of
course it does not make sense to have multiple fragments if one of
them is capitalized (as this one will require an exact match).
* If you want to search for a pattern including white space, use double
quotes (ie: "admin note*").
* If you have a big index (many files), excessively generic fragments
may result in inefficient searches.
* As an example, inst recoll would match recollinstall.in (and quite a
few others...).
The point of having a separate file name search is that wild card
expansion can be performed more efficiently on a relatively small subset
of the index (allowing wild cards on the left of terms without excessive
penality).
All search modes allow wildcards inside terms (*, ?, []). You may want to All search modes allow wildcards inside terms (*, ?, []). You may want to
have a look at the section about wildcards for more information about have a look at the section about wildcards for more information about
@ -667,14 +702,16 @@ More documentation can be found in the doc/ directory or at http://www.recoll.or
---------------------------------------------------------------------- ----------------------------------------------------------------------
3.1.2. The result list 3.1.2. The default result list
After starting a search, a list of results will instantly be displayed in After starting a search, a list of results will instantly be displayed in
the main list window. the main list window.
By default, the document list is presented in order of relevance (how well By default, the document list is presented in order of relevance (how well
the system estimates that the document matches the query). You can specify the system estimates that the document matches the query). You can sort
a different ordering by using the Tools / Sort parameters dialog. the result by ascending or descending date by using the vertical arrows in
the toolbar (the old sort tool is gone after release 1.15, because the new
result table has much better capability).
Clicking on the Preview link for an entry will open an internal preview Clicking on the Preview link for an entry will open an internal preview
window for the document. Further Preview clicks for the same search will window for the document. Further Preview clicks for the same search will
@ -763,7 +800,34 @@ More documentation can be found in the doc/ directory or at http://www.recoll.or
---------------------------------------------------------------------- ----------------------------------------------------------------------
3.1.3. The preview window 3.1.3. The alternate result table
In Recoll 1.15 and newer, the results can now be shown in a
spreadsheet-like display. You can switch to this presentation by clicking
the table-like icon in the toolbar (this is a toggle, click again to
restore the list).
Clicking on the column headers will allow sorting by the values in the
column. You can click again to invert the order, and use the header
right-click menu to reset sorting to the default relevance order.
Both the list and the table display the same underlying results. The sort
order set from the table is still active if you switch back to the list
mode. You can click twice on a date sort arrow to reset it from there.
The header right-click menu allows adding or deleting columns. The columns
can be resized, and their order can be changed (by dragging). All the
changes are recorded when you quit recoll
Hovering over a table row will update the detail area at the bottom of the
window with the corresponding values. You can click the row to freeze the
display. The bottom area is equivalent to a classical result list
paragraph, with links for starting a preview or a native application, and
an equivalent right-click menu.
----------------------------------------------------------------------
3.1.4. The preview window
The preview window opens when you first click a Preview link inside the The preview window opens when you first click a Preview link inside the
result list. result list.
@ -807,7 +871,7 @@ More documentation can be found in the doc/ directory or at http://www.recoll.or
---------------------------------------------------------------------- ----------------------------------------------------------------------
3.1.4. Complex/advanced search 3.1.5. Complex/advanced search
The advanced search dialog helps you build more complex queries without The advanced search dialog helps you build more complex queries without
memorizing the search language constructs. It can be opened through the memorizing the search language constructs. It can be opened through the
@ -874,7 +938,7 @@ More documentation can be found in the doc/ directory or at http://www.recoll.or
---------------------------------------------------------------------- ----------------------------------------------------------------------
3.1.5. The term explorer tool 3.1.6. The term explorer tool
Recoll automatically manages the expansion of search terms to their Recoll automatically manages the expansion of search terms to their
derivatives (ie: plural/singular, verb inflections). But there are other derivatives (ie: plural/singular, verb inflections). But there are other
@ -929,7 +993,7 @@ More documentation can be found in the doc/ directory or at http://www.recoll.or
---------------------------------------------------------------------- ----------------------------------------------------------------------
3.1.6. Multiple databases 3.1.7. Multiple databases
Multiple Recoll databases or indexes can be created by using several Multiple Recoll databases or indexes can be created by using several
configuration directories which are usually set to index different areas configuration directories which are usually set to index different areas
@ -974,7 +1038,7 @@ More documentation can be found in the doc/ directory or at http://www.recoll.or
---------------------------------------------------------------------- ----------------------------------------------------------------------
3.1.7. Document history 3.1.8. Document history
Documents that you actually view (with the internal preview or an external Documents that you actually view (with the internal preview or an external
tool) are entered into the document history, which is remembered. tool) are entered into the document history, which is remembered.
@ -987,7 +1051,7 @@ More documentation can be found in the doc/ directory or at http://www.recoll.or
---------------------------------------------------------------------- ----------------------------------------------------------------------
3.1.8. Sorting search results and collapsing duplicates 3.1.9. Sorting search results and collapsing duplicates
The documents in a result list are normally sorted in order of relevance. The documents in a result list are normally sorted in order of relevance.
It is possible to specify different sort parameters by using the Sort It is possible to specify different sort parameters by using the Sort
@ -1014,9 +1078,9 @@ More documentation can be found in the doc/ directory or at http://www.recoll.or
---------------------------------------------------------------------- ----------------------------------------------------------------------
3.1.9. Search tips, shortcuts 3.1.10. Search tips, shortcuts
3.1.9.1. Terms and search expansion 3.1.10.1. Terms and search expansion
Term completion. Typing Esc Space in the simple search entry field while Term completion. Typing Esc Space in the simple search entry field while
entering a word will either complete the current word if its beginning entering a word will either complete the current word if its beginning
@ -1055,7 +1119,7 @@ More documentation can be found in the doc/ directory or at http://www.recoll.or
---------------------------------------------------------------------- ----------------------------------------------------------------------
3.1.9.2. Working with phrases and proximity 3.1.10.2. Working with phrases and proximity
Phrases and Proximity searches. A phrase can be looked for by enclosing it Phrases and Proximity searches. A phrase can be looked for by enclosing it
in double quotes. Example: "user manual" will look only for occurrences of in double quotes. Example: "user manual" will look only for occurrences of
@ -1074,7 +1138,7 @@ More documentation can be found in the doc/ directory or at http://www.recoll.or
---------------------------------------------------------------------- ----------------------------------------------------------------------
3.1.9.3. Others 3.1.10.3. Others
Using fields. You can use the query language and field specifications to Using fields. You can use the query language and field specifications to
only search certain parts of documents. This can be especially helpful only search certain parts of documents. This can be especially helpful
@ -1109,7 +1173,7 @@ More documentation can be found in the doc/ directory or at http://www.recoll.or
---------------------------------------------------------------------- ----------------------------------------------------------------------
3.1.10. Customizing the search interface 3.1.11. Customizing the search interface
You can customize some aspects of the search interface by using the Query You can customize some aspects of the search interface by using the Query
configuration entry in the Preferences menu. configuration entry in the Preferences menu.
@ -1226,7 +1290,7 @@ More documentation can be found in the doc/ directory or at http://www.recoll.or
---------------------------------------------------------------------- ----------------------------------------------------------------------
3.1.10.1. The result list paragraph format 3.1.11.1. The result list paragraph format
The presentation of each result inside the result list can be customized The presentation of each result inside the result list can be customized
by setting the result list paragraph format inside the User Interface tab by setting the result list paragraph format inside the User Interface tab
@ -1578,7 +1642,7 @@ More documentation can be found in the doc/ directory or at http://www.recoll.or
3.5.1. Hotkeying recoll 3.5.1. Hotkeying recoll
It is surprisingly convenient to be able to show or hide the Recoll GUI It is surprisingly convenient to be able to show or hide the Recoll GUI
with a single keystroke. Recoll comes with a small python script, based on with a single keystroke. Recoll comes with a small Python script, based on
the libwnck window manager interface library, which will allow you to do the libwnck window manager interface library, which will allow you to do
just this. The detailed instructions are on this wiki page. just this. The detailed instructions are on this wiki page.
@ -2190,6 +2254,8 @@ More documentation can be found in the doc/ directory or at http://www.recoll.or
* Zip archives need Python (and the standard zipfile module). * Zip archives need Python (and the standard zipfile module).
* Midi karaoke files need Python and the Midi module
Text, HTML, mail folders, and Scribus files are processed internally. Lyx Text, HTML, mail folders, and Scribus files are processed internally. Lyx
is used to index Lyx files. Many filters need iconv and the standard sed is used to index Lyx files. Many filters need iconv and the standard sed
and awk. and awk.