Release notes for Recoll 1.24.x
Installing over an older version
Some of the input handlers were converted from shell scripts to Python programs, and some helper dependancies changed. For example, you will need to install python-libxml2 and python-libxslt1 in most cases (for replacing xsltproc).
1.20-24 indexes are fully compatible. Installing 1.24 over an 1.19 index is possible, but there have been small changes in the way compound words (e.g. email addresses) are indexed, so it will be best to reset the index. Still, in a pinch, 1.24 search can mostly use an 1.19 index.
New index format with Xapian 1.4: the default on-disk format of Xapian 1.4 (Glass) has changed to improve performance of phrase searches. This had the infortunate consequence of rendering the Recoll snippets generation method excessively slow except for very small indexes. In consequence, new indexes created by Recoll 1.24 using Xapian 1.4 have a different format and store the document texts inside the index. No specific action is required from the user, except if you have and old index and want to use the new format (nicer snippets, faster phrase searches), in which case you should delete the old index (see next).
Always reset the index if you do not know by which version it
was created (e.g.: you're not sure it's at least 1.18). The
best method is to quit all Recoll programs and delete the
index directory (
rm -rf ~/.recoll/xapiandb), then start
recollindex -z will do the same in most, but not all, cases. It's better to use the rm method, which will also ensure that no debris from older releases remain (e.g.: old stemming files which are not used any more).
Case/diacritics sensitivity is off by default. It can be turned on only by editing recoll.conf ( see the manual). If you do so, you must then reset the index.
Changes in Recoll 1.24.0
The main change is the new snippets generation method.
- New snippets generation method, using document text stored in the index (default only for new indexes and Xapian 1.4, can be forced by setting iindexStoreDocText and deleting the old index).
- New range queries : fieldname:min..max, usable only if the field has been appropriately configured.
- Improved support for removable volumes.
- CHM and EPUB indexing: add chmcatenate and epubcatenate to specify that the contents should be indexed as a whole instead of broken up in chapters (resulting in a single search result for the document).
- Added -L option to recoll for forcing message language, overriding NLS environment.
- Fixed clicks on orthographic suggestions which did not work any more with qt5.
- All input handlers should now be compatible with Python3, but still use Python2.
- It should now be possible to use a readonly index directory for searches.
- New idxtexttruncatelen configuration variable to only index the beginning of documents.