web

website/BUGS.html

@@ -29,9 +29,43 @@
 later versions. Bugs listed in the topmost section may also exist in older
 versions.</i></p>
 
-<h2><a name="b_latest">recoll 1.22.0</a></h2>
+<h2><a name="b_latest">recoll 1.21.4, 1.22.0</a></h2>
 <ul>
 
+ <li>There have been multiple occurrences of an indexing problem
+   resulting in a damaged index. The cause is not completely determined,
+   but there is a suspicion that a Xapian bug may be involved at least
+   in some cases.  The index is damaged in such a way that some search
+   results are missing, and that many document up-to-date checks can
+   fail. This makes partial/incremental indexing very expensive because
+   many documents are reindexed (for nothing, the index data is lost
+   anyway).<br/>
+
+   You can see a partial description in Bitbucket Recoll issue #257, but
+   part of the discussion happened on the Xapian mailing list.<br/>
+
+   The problem would signal itself by the following kind of message in
+   the indexer log:<br/>
+
+   <pre><tt>
+:2:../rcldb/rcldb.cpp:1818:Db::needUpdate: get_document error: Document XX not found
+   </tt></pre>
+
+   Also, messages about Xapian being unable to read some blocks. More
+   generally, any error message (beginning with :2:) originating in the rcldb
+   module is highly suspicious.<br/>
+
+   If you get this message, the index is damaged, only deleting it and
+   reindexing can recover it.<br/>
+
+   Olly Betts, the Xapian index developper, thinks that the origin may
+   be a problem which was fixed in Xapian 1.2.21, so, updating Xapian
+   may help. All Xapian 1.2.x versions are binary-compatible (you can
+   just drop them on Recoll), and there are backports repository for
+   several common Linux versions, get in touch if you have a
+   problem.<br/>
+ </li>
+
   <li>The GUI must be restarted after changing the path translation
     values (ptrans), even when they are changed from the GUI
     preferences.</li>

website/CHANGES.html

@@ -70,7 +70,7 @@
 	bugs. Release 1.14.2 fixes the help browser which was broken
 	by 1.14.2. Sigh ...</p>
       <ul>
-	<li><a href="usermanual/RCL.SEARCH.LANG.html">
+	<li><a href="usermanual/usermanual.html#RCL.SEARCH.LANG">
 	    date selection in queries</a>.</li>
 	<li>Pure negative queries (ie: <i>-someterm date:P10D/</i>.</li>
 	<li>Autosuffs: option to automatically turn words into <tt>ext:</tt>

website/credits.html

@@ -25,7 +25,7 @@
 <li><a href="index.html">Home</a></li>
 <li><a href="pics/index.html">Screenshots</a></li>
 <li><a href="download.html">Downloads</a></li>
-<li><a href="usermanual/index.html">User manual</a></li>
+<li><a href="doc.html">User manual</a></li>
 <li><a href="index.html#support">Support</a></li>
 
       </ul>

website/custom.html

@@ -71,7 +71,7 @@ a:hover .PZ3cap { padding:3px 5px; }
         <li><a href="index.html">Home</a></li>
         <li><a href="pics/index.html">Screenshots</a></li>
         <li><a href="download.html">Downloads</a></li>
-        <li><a href="usermanual/index.html">User manual</a></li>
+        <li><a href="doc.html">User manual</a></li>
         <li><a href="index.html#support">Support</a></li>
       </ul>
     </div>
@@ -88,7 +88,7 @@ a:hover .PZ3cap { padding:3px 5px; }
         "almost full" support for HTML capabilities, with a few
         restrictions due to the Qt QTextBrowser object. The details
         are described in the
-        <a href="http://www.recoll.org/usermanual/RCL.SEARCH.html#RCL.SEARCH.GUI.CUSTOM.RESLIST">
+        <a href="http://www.recoll.org/usermanual/usermanual.html#RCL.SEARCH.GUI.CUSTOM.RESLIST">
 	  Recoll manual</a>.</p>
 
       <p>As of Recoll 1.17, the result list is a WebKit object by

website/download.html

@@ -32,7 +32,7 @@ function showdiv(viewid)
         <li><a href="index.html.en">Home</a></li>
         <li><b>Downloads</b></li>
         <li><a href="doc.html">Documentation</a></li>
-  <li><a href="usermanual/RCL.INSTALL.html">Installation</a></li>
+        <li><a href="usermanual/usermanual.html#RCL.INSTALL">Installation</a></li>
         <li><a href="support.html">Support</a></li>
       </ul>
     </div>
@@ -72,7 +72,7 @@ function showdiv(viewid)
         <p>The current version is 1.21.4. <a href="release-1.21.html">Release
             notes</a>.</p>
 
-<p>Recoll <a href="usermanual/RCL.INSTALL.html">Installation / building
+        <p>Recoll <a href="usermanual/usermanual.html#RCL.INSTALL">Installation / building
             manual</a>.</p>
 
         <p>The indexing filters used for some document types may need external
@@ -147,7 +147,7 @@ current <a href="release-1.16.html">1.16 release notes</a>).
             Ubuntu up to 13.04 Raring)<br>
 
             <a href="unity-scope-recoll-1.20.2.4.tar.gz">
-  unity-scope-recoll-1.20.2.4.tar.gz</a> (Recoll 0.19 or 0.20, Ubuntu
+              unity-scope-recoll-1.20.2.4.tar.gz</a> (Recoll 0.19 and later, Ubuntu
             13.10 and later).<br>
 
           </blockquote>
@@ -201,7 +201,7 @@ branch for the current production version.</p>
 
         <p>Normally, it's just <tt>./configure; make; make install</tt>. If a bit
           more detail is needed, 
-  <a href="http://www.recoll.org/usermanual/RCL.INSTALL.BUILDING.html">
+          <a href="http://www.recoll.org/usermanual/usermanual.html#RCL.INSTALL.BUILDING">
             there is some in the manual</a>.
 
       </div>
@@ -231,7 +231,7 @@ many distributions.</p>
 
         <p><i>Except they're not at the moment (2015-10)...</i>. So
           I am maintaining a repository for packages built for Debian Wheezy,
-  and Jessie. This currently has recoll 1.20.6 (the
+          and Jessie. This currently has recoll 1.21.x (the
           standard repos have 1.17...) To add the repository to your
           sources:</p>
 
@@ -280,9 +280,9 @@ a set of Ubuntu series. starting at Lucid. The installation is very simple: </p>
             sudo apt-get install recoll
         </tt></pre>
 
-<p>The 1.19/1.20 packages in the PPA now have a separate package
+        <p>The packages in the PPA now have a separate package for the Python
-  for the Python extension, like the standard ones, so there should be
+          extension, like the standard ones, so there should be no more
-  no more conflict issues while switching from the PPA to the normal
+          conflict issues while switching from the PPA to the normal
           repositories and back.</p>
 
         <h3><a name="mint">Linux Mint</a></h3>
@@ -298,9 +298,9 @@ packages if you want use the source rpms.</p>
         <h3>Fedora</h3>
 
         <p>Recoll is present in the standard Fedora package repositories starting from
-  F-12. Fedora 21 has up to date packages. Here are some packages
+          F-12. Recoll packages in Fedora are usually fairly up to
-  for <a href="fedora20">Fedora 20</a>. There are only x86_64 binaries
+          date. Please get in touch if you have a need for a Recoll package
-  for now, use the source rpm for other archs.</p>
+          for Fedora.</p>
 
         <h3>CentOS 7.1</h3>
 
@@ -326,18 +326,6 @@ packages if you want use the source rpms.</p>
           from the build service repository. Some of the older repositories do
           not build antiword, just tell the software manager to "break" recoll
           by installing anyway, and get antiword somewhere else.</p>
-</div>
-
-<div id="windows">
-<h2><a name="windows">Packages</a></h2>
-<h3>Microsoft Windows</h3>
-
-<p>The port of Recoll to Windows is still a bit experimental and
-lacking things like real-time indexing or spelling
-  suggestions. However it works well enough to be useful. More info
-  and links to the setup
-  files <a href="pages/recoll-windows.html">here</a>.</p> 
-</div>
 
         <!--
         <h3>Mageia</h3>
@@ -352,6 +340,17 @@ lacking things like real-time indexing or spelling
         </p>
         -->
 
+
+        <div id="windows">
+          <h3><a name="windows">Microsoft Windows Setup Files</a></h3>
+
+          <p>The port of Recoll to Windows is still a bit experimental and
+            lacking things like real-time indexing or spelling
+            suggestions. However it works well enough to be useful. More info
+            and links to the setup
+            files <a href="pages/recoll-windows.html">here</a>.</p>
+        </div> <!-- windows -->
+
       </div> <!-- Packages -->
 
       <div id="ports">
@@ -411,11 +410,11 @@ Bitbucket).</p>
         </p>
 
         <p>Note that, if you are running an older release, you may find updated
-messages by looking inside the appropriate maintenance branch on <a
+          messages by looking inside the appropriate maintenance
-href="https://bitbucket.org/medoc/recoll/src">bitbucket</a>.</p>
+          branch on
+          <a href="https://bitbucket.org/medoc/recoll/src">bitbucket</a>.</p>
 
       </div> <!-- translations -->
-
     </div> <!-- content -->
 
   </body>

website/features.html

@@ -26,7 +26,7 @@
 
         <li><a href="download.html">Downloads</a></li>
 
-        <li><a href="usermanual/index.html">User manual</a></li>
+        <li><a href="doc.html">Documentation</a></li>
 
         <li><a href="support.html">Support</a></li>
 
@@ -418,7 +418,7 @@ application/x-tar = execm rcltar
             Web UI</a> lets you query a Recoll index from a web browser</li>
       </ul>
       <p>Recoll also has 
-	<a href="usermanual/RCL.PROGRAM.API.html#RCL.PROGRAM.API.PYTHON">
+	<a href="usermanual/usermanual.html#RCL.PROGRAM.API.PYTHON">
 	  <span class="application">Python</span></a> and
 	<span class="application">PHP</span> modules which can allow
 	easy integration with web or other applications.</p>

website/helpernotes.html

@@ -28,7 +28,7 @@
 
         <li><a href="download.html">Downloads</a></li>
 
-        <li><a href="usermanual/index.html">User manual</a></li>
+        <li><a href="doc.html">User manual</a></li>
 
         <li><a href="index.html#support">Support</a></li>
 

website/id3lib.html

@@ -24,7 +24,7 @@
 	<li><a href="features.html">Features</a></li>
 	<li><a href="pics/index.html">Screenshots</a></li>
 	<li><a href="download.html">Downloads</a></li>
-	<li><a href="usermanual/index.html">User manual</a></li>
+	<li><a href="doc.html">User manual</a></li>
 	<li><a href="index.html#support">Support</a></li>
 	<li><a href="devel.html">Development</a></li>
       </ul>

website/index.html.en

@@ -98,6 +98,13 @@
       
       <dl>
 
+        <dt>2016-01-12</dt><dd>It seems that we currently have a
+          relatively frequent problem resulting in damaged indexes. If
+          you are experimenting heavy reindexing (incremental indexing
+          takes longer than it should), or missing search results,
+          please take a look at the top of
+          the <a href="BUGS.html">known bugs page</a></dd>
+
         <dt>2016-01-12</dt><dd>Release 1.21.4 is out.</dd>
 
         <dt>2015-11-09</dt>

website/release-1.16.html

@@ -96,7 +96,7 @@
           the text). This is useful for example in the very common
           case where the metadata for the author list was not
           created. More details about this feature are to be found in
-          the <a href="http://www.recoll.org/usermanual/index.html">user
+          the <a href="http://www.recoll.org/doc.html">user
           manual</a>.</li> 
 
         <li>It is possible to configure the result list snippet