Release notes for Recoll 1.17.x

Caveats

Installing over an older version: 1.17 is fully compatible with 1.16 indexes, and mostly compatible with 1.15 ones, except for a few differences for weird terms containing punctuation signs. Perform a full index pass if installing over an older version. The simplest way to do this is to quit all recoll programs and just delete the index directory (rm -rf ~/.recoll/xapiandb), then start recoll or recollindex. recollindex -z will do the same in most cases.

Some new, auxiliary, features do require a full reindex to work:

• The file size filtering functions.
• The anchored search feature if the index was created by release 1.15 or older.

Changes

Recoll 1.17 is an incremental improvements release over 1.16, with quite a few changes under the hood (like the introduction of a webkit-based result list), but relatively few obvious changes for the casual user.

Note to packagers: you need to either depend on libqt4-webkit or run configure --disable-webkit (1st option preferred if possible of course).

• Search: Recoll now supports filtering on file sizes. This is accessible from the advanced search panel, or from the query langage (ie: "size>10k size<1m"). For documents stored inside archives, the file size stored in the index is now the actual one, not the archive's as was previously the case. Because of this, you will need a full reindex to completely enable this feature.
• Query language: the "dir:" directive now accepts non-absolute paths. For example dir:dir1/dir2 will select any file the path of which includes "dir1/dir2".
• Query language: tilde is now expanded inside a "dir:" clause.
• GUI: it is now possible to cancel a query that takes too long. Because of limitations in Xapian, this forces a program exit, but it's probably better than staring at a hung Recoll.
• GUI/config: new set of dialogs to set up the indexing schedule, either as automatic real time indexing started with the user session or as discrete cron entries. This will take care of the details of autostart files or crontab editing.
• GUI: use Shift+PageUp instead of Shift+Home to rewind the result list to the first page. Shift+Home is useful in the search entry.
• GUI: the preview function will now check that the index is up to date before fetching the preview data, and propose to update the index if necessary. This is especially important for mail folders. It was previously possible that the preview would display a message unrelated to the current result.
• GUI: it is now possible to control the date format displayed by the results (go to Query Preferences).
• GUI: when a search fails to retrieve results, the spelling suggestions are now presented as links inside the result list area. Clicking a link will replace the appropriate word inside the search entry.
• GUI: thumbnails will be displayed in the result list if found in the standard freedesktop thumbnails directory (previously created by gimp or some file manager). This Recoll release will not create thumbnails.
• GUI: it is now possible to Copy/Paste from the term explorer result list.
• GUI: what used to be the document category filters (media/text/etc.) are now defined as query language fragments inside mimeconf. This means that you can redefine them freely (see the comments for the [guifilters] section in the default mimeconf).
• GUI: it is now possible to use a Qt style sheet to modify many aspects of Recoll appearance. A style sheet file can be selected from the GUI query configuration dialog. A sample skeleton style sheet is to be found in the share/recoll/examples directory.
• GUI: the result list is now based on the WebKit widget instead of QTextBrowser. This means better HTML/CSS support, and even Javascript ... You can force the use the old QTextBrowser instead by using configure --disable-webkit. See a few CSS examples in the result list customisation examples page
• GUI: added menu entry to show all the mime types actually indexed.
• GUI/indexing: the indexing thread has been removed. All indexing is now performed by a separate recollindex process. This has multiple advantages, the thread was just a very bad idea. Among others, exiting the GUI has no influence on an ongoing indexing.
• GUI/indexing: new menu entry to force a full reindex.
• GUI/config: the indexing configuration now only shows the directories customized by the user, not those which come from the standard configuration (ie: ~/.thunderbird). Showing the standard directories was more often confusing than useful.
• GUI: the default result list paragraph now displays the ipath: this is very useful for archive members and not too disturbing for other kinds.
• Command line query: can now select a result slice (first result rank and count of results). New option for easy parsing of results by another program.
• Indexing: handle the html5 charset meta tag.
• Indexing: added support for Okular notes and Gnumeric.
• Real time indexer: restart automatically when the configuration changes.
• Fixed bugs:
  • Indexing configuration: deleting one customized directory would sometimes delete the whole list (depending on Qt version I think).
  • Indexing configuration: adding a customized directory would not make it the active/current one (so that another click was needed to choose it before making modifications).
  • The GUI preview now performs an up to date check before displaying data from a subdocument, and proposes to reindex the container if it changed. This is mostly useful for mailbox containers, where preview would sometimes display the wrong message (if the folder had been compacted).
  • Fix a bug in html charset detection. The wrong charset was sometimes used for GUI preview.
  • The chm filter can now process files lacking a Topics node.
  • The default slack for proximity searches from the query language (ie: "word1 word2"p) had become 0. It was restored to 10.