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.
+
+ 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.
+
+ - The unac_except_trans mechanism can generate wrong
+ character translations in some cases.
+ - The real time monitor can be terminated for for permissions-related
+ addwatch errors that should be non-fatal.
+ - ODF documents exported by Google docs are badly
+ processed.
+ - It is impossible to open the parent of an
+ embedded document (e.g. the CHM file for an HTML page
+ inside the CHM) if the parent is itself a member of an
+ archive.
+
- Text inside malformed HTML files (appearing before a <body>
tag, or after a second one, or after a </body> tag is
not indexed. As it would be displayed by current browsers,
this is wrong.
- - 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.
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:
-
- - The file size filtering functions if the existing index was
- created by version 1.16 or older.
- - The anchored search feature if the index was created by
- release 1.15 or older.
-
+ 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:
- The unac_except_trans mechanism could be buggy in some
@@ -147,7 +174,10 @@
addwatch error.
- Fix handling of ODF documents exported by Google
docs.
-
+ - It was previously impossible to open the parent of an
+ embedded document (e.g. the CHM file for an HTML page
+ inside the CHM) if the parent was itself a member of an
+ archive.