From a162c3197e47e0fd0dbead8a7f6d631c21e94f94 Mon Sep 17 00:00:00 2001 From: Jean-Francois Dockes Date: Tue, 16 Oct 2012 13:35:49 +0200 Subject: [PATCH] doc --- website/BUGS.html | 51 ++++++++++++-------- website/release-1.18.html | 98 +++++++++++++++++++++++++-------------- 2 files changed, 96 insertions(+), 53 deletions(-) diff --git a/website/BUGS.html b/website/BUGS.html index 3a549303..0fb21d64 100644 --- a/website/BUGS.html +++ b/website/BUGS.html @@ -36,33 +36,46 @@ topmost section may also exist in older versions.

+

recoll 1.18.0

+
  • It will sometimes happen that the result list paragraph + format stored in the Qt preferences file will get garbled, + causing result lists with no displayed paragraphs (the + counts and pages are ok, the results can be seen in table + mode, but not in list mode). The workaround is to go to +
    + Preferences->Query configuration->User interface +
    and erase the result paragraph format string + (^A DEL in the text area), this will reset the string to the + default value.
    • + +
  • Real time indexer: when running with gamin on FreeBSD, the + indexer can deadlock in the gamin dialog in some + cases.
    • + +
  • After an upgrade, the recoll GUI sometimes crashes on + startup. This is fixed by removing (back it up just in case) + ~/.config/Recoll.org/recoll.conf, the QSettings storage for + recoll.
    • +

    recoll 1.17.3

    recoll 1.17.2

    diff --git a/website/release-1.18.html b/website/release-1.18.html index 7a9bb619..3747941e 100644 --- a/website/release-1.18.html +++ b/website/release-1.18.html @@ -36,31 +36,44 @@

    Installing over an older version: 1.18 introduces serious index formats changes, and it will be advisable to reset the index - in most cases. IF the 1.18 index is not configured for - case and diacritics sensitivity, it is mostly compatible with - 1.17 indexes though. Case/diacritics sensitivity can be turned - off either by a compile flag or a configuration variable, and - the default is still a stripped index (so, mostly compatible - with 1.17). If you activate case and diacritics sensitivity, - you must reset the index.

    + in most cases. This will be best done by destroying the + index directory (rm -rf ~/.recoll/xapiandb).

    -

    Always reset the index if installing over an older version (1.14 +

    If the 1.18 index is not configured for case and + diacritics sensitivity, it is mostly compatible with 1.17 + indexes though.

    + +

    Case/diacritics sensitivity is off by default. For 1.18, it can be + turned on only by editing recoll.conf by hand (see the + manual). If you do so, you must reset the index.

    + +

    Always reset the index if installing over an older version (1.16 and older). 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 also require a full reindex:

    - + class="literal">recollindex -z will do the same in + most, but not all, cases.

    +

    The subdirectories of xapiandb which were previously used to + store the stem expansion database (stem_english, + stem_french...) are not used anymore, because the data is now + stored in the Xapian synonyms table. They will stay around if + you do nothing about them, so you may want to delete them if + you have not chosen to just delete the whole index + directory.

    +

    Viewer exceptions: + There is a new list of mime types that should be opened with + the locally configured application even when Use + Desktop Preferences is checked. This allows making + use of new function (direct access to page), which could + not be available through the desktop's xdg-open. + The default list contains PDF, + Postscript and DVI, so you may want to reset it after + installation if you want to keep the previous behaviour + (losing the page number functionality). This can be done + from the Preferences->Gui Configuration menu.

    Changes

    @@ -79,7 +92,12 @@ what is used for stemming. See the manual chapter for details about controlling the - feature. + feature. The capacity for case/diacritics sensitivity is + off by default, and you should not see differences in this + respect after upgrading if you do not turn it on + explicitely. Even on a raw index, most searches should + behave like they did in 1.17. Sensitivity must be + explicitely requested in most cases.
  • Recoll has a new capacity to store page break locations and use them when opening a document at the location for a @@ -89,10 +107,25 @@
  • Recoll can now also pass a search string to the native application.
    • +
  • There is a list of mime types that should be opened with + the locally configured application even when Use + Desktop Preferences is checked. This will permit, for + example, using evince for its page access capabilities on + PDF files, while letting the desktop handle all the other + mime types. The list is not empty by default, it contains PDF, + Postscript and DVI, so you may want to reset it after + installation if you want to keep the previous behaviour + (losing the page number functionality). This can be done + from the Preferences->Gui Configuration menu.
    • +
  • The GUI result list has a new "snippets" window for documents with page numbers, which let the user choose a snippet and open the document at the appropriate page.
    • +
  • The advanced search screen now has a history + function. While the focus is in this window, you + can walk the history of searches using the up and down arrows.
    • +
  • We now allow multiple directory specifications in the query language, as in: dir:/home/me -dir:tmp
    • @@ -108,14 +141,15 @@ option to display plain text: it will better respect indentation, while folding long lines. -
  • When running in an UTF-8 locale, and after decoding a - plain text file as UTF-8 fails, indexing will try again - using an 8bit character set heuristically chosen according - to the locale country code.
    • +
  • When running in an UTF-8 locale, and after failing to decode a + plain text file as UTF-8, indexing will try again using an 8 bit + character set heuristically chosen according to the locale + country code.
    • -
  • A new configuration, maxmemberkbs, has been implemented to - limit the size of archive members we process. This will avoid - recoll trying to read a 4 GB ISO from a zip archive...
    • +
  • A new configuration variable, maxmemberkbs, has been + implemented to limit the size of archive members we process. This + will avoid trying to read a 4 GB ISO from a zip archive as + happened in the past...
  • Proper error reporting when a wildcard expansion is truncated for size. An incomplete search could previously be @@ -132,13 +166,6 @@
  • Partial autodetection of thunderbird mailboxes found out of the configured location.
    • -
  • Implemented a list of mime types that should be opened - with the locally configured application even when Use - Desktop Preferences is checked. This will permit, for - example, using evince for its page access capabilities on - PDF files, while letting the desktop handle all the other - mime types.
    • -
  • Fixed bugs: