--- a/website/release-1.17.html
+++ b/website/release-1.17.html
@@ -45,30 +45,62 @@
recollindex. <span class="literal">recollindex -z</span>
will do the same in most cases.</p>
- <p>Also, using the anchored search feature on an 1.15 index
- requires a full reindex.</p>
+ <p>Some new, auxiliary, features do require a full reindex to work:</p>
+ <ul>
+ <li>The file size filtering functions.</li>
+ <li>The anchored search feature if the index was created by
+ release 1.15 or older.</li>
+ </ul>
<h2>Changes</h2>
- <p>Recoll 1.17 is an incremental improvements release over 1.16, no
- really major function was introduced or modified.</p>
+ <p>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.</p>
<ul>
- <li>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.</li>
-
- <li>Query language: tilde is now expanded inside a "dir:"
- clause.</li>
+ <li>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.</li>
<li>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".</li>
+
+ <li>Query language: tilde is now expanded inside a "dir:"
+ clause.</li>
+
+ <li>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.</li>
+
+ <li>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.</li>
+
+ <li>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.</li>
+
+ <li>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.</li>
+
+ <li>GUI: it is now possible to control the date format
+ displayed by the results (go to Query Preferences).</li>
<li>GUI: when a search fails to retrieve results, the spelling
suggestions are now presented as links inside the result list
@@ -77,15 +109,19 @@
<li>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). Recoll
- will not create thumbnails (this would slow the results display
- too much).</li>
-
- <li>GUI: it is now possible to control the date format used to
- display the results (go to Query Preferences).</li>
+ (previously created by gimp or some file manager). This Recoll
+ release will not create thumbnails.</li>
<li>GUI: it is now possible to Copy/Paste from the term explorer
result list.</li>
+
+ <li>GUI: what used to be the document category filters
+ (media/text/etc.) are now defined as query language
+ fragments
+ inside <span class="filename">mimeconf</span>. This means
+ that you can redefine them freely (see the comments for the
+ <tt>[guifilters]</tt> section in the
+ default <span class="filename">mimeconf</span>).</li>
<li>GUI: it is now possible to use a Qt style sheet to modify
many aspects of Recoll appearance. A style sheet file can be
@@ -93,62 +129,44 @@
skeleton style sheet is to be found in the
share/recoll/examples directory.</li>
+ <li>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 <a href="custom.html">result list customisation
+ examples page</a></li>
+
<li>GUI: added menu entry to show all the mime types actually
indexed.</li>
- <li>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.</li>
-
- <li>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.</li>
-
- <li>The GUI now has a 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.</li>
-
- <li>The GUI 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.</li>
-
- <li>The GUI now has a menu entry to force a full reindex.</li>
-
- <li>The GUI 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.</li>
-
- <li>GUI: the default reslist paragraph now displays the ipath:
+ <li>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.</li>
+
+ <li>GUI/indexing: new menu entry to force a full reindex.</li>
+
+ <li>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.</li>
+
+ <li>GUI: the default result list paragraph now displays the ipath:
this is very useful for archive members and not too
disturbing for other kinds.</li>
- <li>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.</li>
-
- <li>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).</li>
-
<li>Command line query: can now select a result slice
- (first result rank and count of results).</li>
-
- <li>Indexer: handle the html5 <tt>charset</tt> meta tag.</li>
+ (first result rank and count of results). New option for
+ easy parsing of results by another program.</li>
+
+ <li>Indexing: handle the html5 <tt>charset</tt> meta tag.</li>
+ <li>Indexing: added support for Okular notes and Gnumeric.</li>
<li>Real time indexer: restart automatically when the
configuration changes.</li>
-
- <li>Indexer: Added okular notes and gnumeric filters.</li>
<li>Fixed bugs: