Commits

medoc committed 9bd31b1

doc

Comments (0)

Files changed (6)

website/BUGS.html

           topmost section may also exist in older versions.</i></p>
 
       
-      <h2><a name="b_latest">recoll 1.18.003</a></h2> 
+      <h2><a name="b_latest">recoll 1.18.1</a></h2> 
       <ul>
+
+        <li>Weird data in filter output text (e.g.: produced by some
+          versions of pdftotext) can cause an error which will halt
+          the processing of the document, which becomes
+          unsearchable. This is a relatively uncommon problem which
+          signals itself by a specific error in the indexing log, so
+          you can know if you are affected. Look for:
+          <tt>xapian add_posting error Empty termnames aren't allowed</tt>
+        </li> 
+
+        <li>Raw indexes (not default): diacritics and case expansion
+          is not applied to terms containing numbers so that a
+          case-insensitive search does not work for them (e.g.:
+          searching for ds1820 will not find DS1820).</li>
+
       <li>On systems such as Debian Stable which use Evince version
         2.x (not 3.x) as PDF viewer, the default "Open" command for
         PDF files will not work. You need to edit the command:

website/download.html

 
       <h2><a>General information</a></h2>
 
-      <p>The current version is 1.17.3. <a href="release-1.17.html">
+      <p>The current version is 1.18.1. <a href="release-1.18.html">
           Release notes</a>.</p>
 
-      <p>The download page for Recoll 1.16 is
-	<a href="download-1.16.html">still available</a>.</p>
+      <p>The download page for Recoll 1.17 is
+	<a href="download-1.17.html">still available</a>.</p>
 
       <p>Recoll <a href="usermanual/rcl.install.html">
 	  Installation / building manual</a>.</p> 
 	and moving from X.Y.Z to X.Y.Z+u should in general involve
 	little risk of regression. But, <em>any</em> change can bring
 	problems, if you are not affected by the corrected bugs (check
-	the <a href="CHANGES.html">changes file</a>), there is
+	the <a href="release-1.18.html">release file</a>), there is
 	probably no necessity to upgrade anyway.</p>
 
       <h2><a name="source">Source</a></h2>
 
-      <h3>Current release distribution: 1.17.3:</h3> 
+      <h3>Current release distribution: 1.18.1:</h3> 
       <!-- Attention: source packages must remain here, not in a
         subdirectory, because of all the places they're referred from
         (package watches) -->
-       <p><a href="recoll-1.17.3.tar.gz">recoll-1.17.3.tar.gz</a>.
+       <p><a href="recoll-1.18.1.tar.gz">recoll-1.18.1.tar.gz</a>.
        </p>
 
 <!--
         <li><p>Qt development files: Qt 4.4 or newer. The Recoll GUI
             will not build with Qt releases older than 4.4.</p></li>
 
+        <li><p>Qt webkit development: Qt WebKit is quite often
+            distributed apart from the main Qt lib. It is possible to
+            configure Recoll not to use Qt WebKit (see 
+            configure&nbsp;--help).</p></li>
+
         <li>Python development package: you can avoid needing this by
           configuring with --disable-python-module.</li>
 
 
       <h3>Older recoll releases:</h3>
        <p>
-        <a href="recoll-1.17.2.tar.gz">1.17.2</a>.
-        <a href="recoll-1.17.1.tar.gz">1.17.1</a>.
+       <p>
+        <a href="recoll-1.17.3.tar.gz">1.17.3</a>.
         <a href="recoll-1.16.2.tar.gz">1.16.2</a>.
         <a href="recoll-1.15.9.tar.gz">1.15.9</a>.
         <a href="recoll-1.14.4.tar.gz">1.14.4</a>.
           other releases too). Just follow the instructions for Ubuntu.</p>
         
       <h3>RPMS</h3> 
-
-       <p>Some Fedora and Mandriva packages unfortunately think that they
-	depend on exiftool (which is needed by the little used jpeg
-	info filter), due to excessive rpmbuild	cleverness.
-	<br>You'll need to install the Xapian, Qt, and zlib development
-	  packages if you want use the source rpms.</i></p>
+	<p>You'll need to install the Xapian, Qt, Qt-Webkit and zlib
+	  development packages if you want use the source rpms.</p>
 	  
       <h3>Fedora</h3>
       <p>Recoll is present in the standard Fedora package
           somewhere else.</p>
       </blockquote>
 
-      <h3>Mandriva</h3>
+      <h3>Mageia</h3>
       <blockquote>
 
-        <p>Mandriva linux 2011 using Qt 4 and the Xapian version
-             from the Mandriva repository.: 
-	  <a href="mandriva2011/recoll-1.17.2-1-mdv2011.0.i586.rpm">
-	    recoll-1.17.2-1-mdv2011.0.i586.rpm</a>, 
-          <a href="recoll-debug-1.17.2-1-mdv2011.0.i586.rpm">
-            recoll-debug-1.17.2-1-mdv2011.0.i586.rpm</a>. <br>
+        <p>Mageia version 2: 
+	  <a href="mageia2/recoll-1.18.1-1.mga2.i586.rpm">
+	    mageia2/recoll-1.18.1-1.mga2.i586.rpm,
+          <a href="mageia2/recoll-debug-1.18.1-1.mga2.i586.rpm">
+            recoll-debug-1.18.1-1.mga2.i586.rpm</a>. <br>
 	  Source: 
-	<a href="mandriva2011/recoll-1.17.2-1.src.rpm">
-	  recoll-1.17.2-1.src.rpm</a>
+	<a href="mageia2/recoll-1.18.1-1.mga2.src.rpm">
+	  recoll-1.18.1-1.mga2.src.rpm</a>
         </p>
       </blockquote>
 
 
       <h2><a name="translations">Translations</a></h2>
 
-      <p>Most of the translations for 1.17 are incomplete
+      <p>Most of the translations for 1.18 are incomplete
 	The source translation files are included in the source
 	release. If your language has some english messages left and
 	you want to take a shot at fixing the problem, you can send
       </p>
 
       <p><a href="translations/recoll_xx.ts">recoll_xx.ts</a> is a blank
-	Recoll 1.17 message file, handy to work on a new translation.</p>
+	Recoll 1.18 message file, handy to work on a new translation.</p>
 
-      <h3>Updated 1.17 translations that became available after the
+      <p>A Czech translation for 1.18, thanks to Pavel
+	<a href="translations/recoll_cs.ts">recoll_cs.ts</a>
+	<a href="translations/recoll_cs.qm">recoll_cs.qm</a>
+      </p>
+
+<!--
+      <h3>Updated 1.18 translations that became available after the
 	release:</h3>
 
       <p>A Greek translation for 1.17, thanks to Dimitrios
 	<a href="translations/recoll_el.ts">recoll_el.ts</a>
 	<a href="translations/recoll_el.qm">recoll_el.qm</a>
       </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 href="https://bitbucket.org/medoc/recoll/src">bitbucket</a>.</p>
 
 
-<!--  
-      <p>A new Spanish translation for 1.16.2, thanks to JCP.
-	<a href="translations/recoll_es.ts">recoll_es.ts</a>
-	<a href="translations/recoll_es.qm">recoll_es.qm</a>
-      </p>
-
-      <p>The following are up to date in 1.16.2, but may be useful if you
-        are running 1.16.1.</p>
-      <p>Czech, thanks to Pavel.
-	<a href="translations/recoll_cs.ts">recoll_cs.ts</a>
-	<a href="translations/recoll_cs.qm">recoll_cs.qm</a>
-	</p> 
-      <p>Russian, thanks to Gleb.
-	<a href="translations/recoll_ru.ts">recoll_ru.ts</a>
-	<a href="translations/recoll_ru.qm">recoll_ru.qm</a>
-	</p> 
-      <p>Lithuanian. 
-	<a href="translations/recoll_lt.ts">recoll_lt.ts</a>
-	<a href="translations/recoll_lt.qm">recoll_lt.qm</a>
-	</p> 
-      <p>Ukrainian. 
-	<a href="translations/recoll_uk.ts">recoll_uk.ts</a>
-	<a href="translations/recoll_uk.qm">recoll_uk.qm</a>
-	</p> 
-      <p><b>Italian</b>. Thanks to Mario, Christian and Giovanni for this.
-	<a href="translations/recoll_it.ts">recoll_it.ts</a>
-	<a href="translations/recoll_it.qm">recoll_it.qm</a>
-	</p> 
-      <p><b>Turkish</b>. Thanks Serdar.
-	<a href="translations/recoll_tr.ts">recoll_tr.ts</a>
-	<a href="translations/recoll_tr.qm">recoll_tr.qm</a>
-	</p> 
--->
-
     </div>
   </body>
 </html>

website/index.html.en

         <li><a href="features.html">Detailed features</a>.
       </ul>
       <p>The current <span class="application">Recoll</span> version is
-	<a href="download.html">1.17.3</a> 
-	(<a href="release-1.17.html">Release notes</a>).</p>
+	<a href="download.html">1.18.1</a> 
+	(<a href="release-1.18.html">Release notes</a>).</p>
 
       <p><span class="application">Recoll</span> is based on the very
         strong <a href="http://www.xapian.org">Xapian</a> search
 
       <h2>News</h2>
       <div class="news">
-      <ul>
+      <dl>
+        <dt>2012-11-05</dt><dd>Recoll 1.18.1 is out. It has optional
+          character case and diacritics 
+          sensitivity, direct access to the hit page when opening PDF
+          files, complex search history, and a host of other smaller
+          improvements. See the <a href="release-1.18.html">release
+            notes</a>.
+          <span class="important">Those of you not using <b>evince</b>
+          as a PDF/Postscript/DVI viewer may be surprised to see the
+          recoll GUI try to use this viewer anyway.</span>This is because
+            some of the new functions in 1.18 work better
+            with <b>evince</b>, but you can override the choice by
+            going to the GUI preferences, and removing
+            application/pdf, application/postscript and
+            application/dvi from the <tt>Exceptions</tt> list.
+        </dd>
 
-        <li>2012-10-30: Recoll has a brand new Firefox extension for
+        <dt>2012-10-30</dt> <dd>Recoll has a brand new Firefox extension for
           indexing visited Web pages. This is very similar to the old
           Beagle plugin, but slightly better integrated (no-fuss
           installation), and with a new lease on life. See
           <a href="https://sourceforge.net/projects/recollfirefox/">
             Dave King's project page on sourceforge</a> and the
           <a href="https://bitbucket.org/medoc/recoll/wiki/IndexWebHistory">
-            page about Recoll (trivial) configuration</a>.</li>
+            page about Recoll (trivial) configuration</a>.</dd>
 
-        <li>2012-10-30: the source for <a href="recoll-1.18.003.tar.gz">
+        <dt>2012-10-30</dt> <dd>The source for <a href="recoll-1.18.003.tar.gz">
             recoll 1.18.003</a> is available, and this is a call to
             volunteers to test it. There are binary packages on the recoll
             "experimental" PPA for Ubuntu and Mint Linux users, and I can
             build others. See this
      <a href="http://www.freelists.org/post/recoll-user/recoll-1180-prerelease">
             message</a> for more information. Mini-release 003 fixes a GUI
-            crash and a few other issues in 002.</li>
+            crash and a few other issues in 002.</dd>
+        </dd>
 
-        <li>2012-10-25: a problem with a simple workaround has caused
+        <dt>2012-10-25</dt> <dd>A problem with a simple workaround has caused
           several reported <span class="important">recollindex
           crashes</span> recently (for 1.17). If you store and index
           Mozilla/Thunderbird email out of the standard location
           possibly use all the computer's memory and crash. Apart from
           crashes, which only occur for very big folders, this also
           causes incorrect mail indexing.
-        </li>
+        </dd>
 
-        <li>2012-10-16: <a href="filters/filters.html">new filter for
-            EPUB documents</a>.</li> 
-        <li>2012-10-16: recoll 1.18 will soon be out. It will have
+        <dt>2012-10-16</dt><dd> <a href="filters/filters.html">new filter for
+            EPUB documents</a>.</dd>
 
-          optional character case and diacritics sensitivity, direct
-          access to hit page when opening PDF files, complex search
-          history, and a host of other smaller improvements. You can
-          already see the <a href="release-1.18.html">release
-          notes</a> and the snapshot currently on the 
-          <a href="https://launchpad.net/~recoll-backports/+archive/experiments"> 
-            "experimental" Ubuntu PPA</a> is actually a release
-            candidate, so Ubuntu users can take an early plunge...</li>
-
-        <li>2012-09-21: an
+        <dt>2012-09-21</dt><dd>An
           <a href="https://bitbucket.org/medoc/recoll/wiki/ElinksBeagle">easy
                  way</a> to extend the "Beagle queue"
          Recoll web history indexing mechanism to other browsers than
          Firefox (Elinks in this case).
-         </li>
+        </dd>
 
-        <li>2012-09-13: the next Recoll version will maybe acquire switchable
+        <dt>2012-09-13</dt> <dd>The next Recoll version will
+          acquire switchable 
           case and diacritics sensitivity. I am writing 
           a few pages about the
           issues involved, they are referenced from my  
           <a href="https://plus.google.com/u/0/113262930843833486941/posts">
-            google+</a> profile</li>
+            google+</a> profile</dd>
 
-        <li>2012-09-11: a new user-contributed script for those who use
+        <dt>2012-09-11</dt> <dd>A new user-contributed script for those who use
           real-time indexing on laptops: stop or start indexing
           according to AC power status. See the details on
           the <a href="https://bitbucket.org/medoc/recoll/wiki/IndexOnAc.wiki">
-            Wiki</a>. </li>
+            Wiki</a>. </dd>
 
-        <li>2012-06-19: update info. If you are not running Recoll 1.17.3,
-          you probably should. 1.17.2 and older versions have a bug which
+        <dt>2012-06-19</dt> <dd>Update info. If you are not running
+          Recoll 1.17.3, you probably should. 1.17.2 and older versions
+          have a bug which 
           can cause a crash of the indexing process while processing email,
           under relatively common conditions.<br>
           Also, if you are already running 1.17.3, you may want to install
-          the updated open/libre-office filter described just below.</li>
+          the updated open/libre-office filter described just below.</dd>
 
-        <li>2012-06-01: an
+        <dt>2012-06-01</dt> <dd>An
           updated <a href="filters/filters.html">filter</a> for the 
           OpenDocument format will properly handle exported Google Docs
-          files.</li> 
+          files.</dd> 
 
-        <li>2012-05-25: a
-          new <a href="filters/filters.html">filter</a> for indexing
-          tar archives.</li>
+        <dt>2012-05-25</dt> <dd>A
+          new <a href="filters/filters.html">filter</a> for indexing 
+          tar archives.</dd>
 
-        <li>2012-05-23: Release 1.17.3 mostly fixes an indexing crash that
-          sometimes occurred  while processing email. See the 
-          <a href="release-1.17.html">Release notes</a>. 
-        </li>
+        <dt>2012-04-07</dt><dd>We now have a Chinese user manual:
+        Recoll现在有中文手册咯: 
+        <a href="http://stupidbeauty.com/Blog/2012/03/recoll%E7%94%A8%E6%88%B6%E6%89%8B%E5%86%8A%E7%BF%BB%E8%AD%AF%EF%BC%8Crecoll-user-manual-2/">
+          Recoll中文手册,HTML</a></dd>
 
-        <li>2012-04-07: we now have a Chinese user manual: Recoll现在有中文手册咯:
-        <a href="http://stupidbeauty.com/Blog/2012/03/recoll%E7%94%A8%E6%88%B6%E6%89%8B%E5%86%8A%E7%BF%BB%E8%AD%AF%EF%BC%8Crecoll-user-manual-2/">
-          Recoll中文手册,HTML</a></li>
-
-        <li>2012-03-27: Recoll gets a Ubuntu Unity Lens. If you are running
+        <dt>2012-03-27</dt> <dd>Recoll gets a Ubuntu Unity Lens. If
+        you are running
           an Ubuntu release where this makes sense, you can install
           the recoll-lens package from the 
           <a href="https://launchpad.net/~recoll-backports/+archive/recoll-1.15-on">
           extract and display embedded documents, which native utilities
           can't reach directly. And of course you still need to run
           the GUI (or the command line recollindex) to get the indexing
-          going !</li>
+          going !</dd>
 
-        <li>2012-03-24: Release 1.17 is out, see
-          the <a href="release-1.17.html">Release notes</a>. </li>
-
-        <li>2011-11-26: the result list glitch: ennoying and easily
-          worked-around: it will sometimes happen (for a yet
-          undetermined reason) 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
-          <blockquote>
-           Preferences->Query configuration->User interface
-          </blockquote> and erase the result paragraph format string
-          (^A DEL in the text area), this will reset the string to the
-          default value.</li>
-
-
-      </ul>
+      </dl>
       </div>
 	
       <h2>Thanks</h2>

website/index.html.fr

       <p><span class="application">Recoll</span> est un logiciel libre
 	gratuit, dont le code source est disponible sous licence GPL.
 	La derni�re version est 
-        <a class="important" href="download.html">1.17.3</a>
-	(<a href="release-1.17.html">notes sur la version, en
+        <a class="important" href="download.html">1.18.1</a>
+	(<a href="release-1.18.html">notes sur la version, en
 	anglais</a>)</p> 
 
       <p>L'interface utilisateur de 
         des questions fr�quentes et trucs divers</a> sur bitbucket.org</p>
 
       <h2>Nouvelles: </h2>
-      <ul>
+      <dl>
 
-        <li>2012-10-25: Un probl�me avec une solution simple peut provoquer
+        <dt>2012-11-05</dt><dd>Recoll 1.18.1 est disponible. Cette
+          version peut faire des recherches sensibles aux majuscules et
+          aux accents, donner un acc�s direct � la bonne page pour les
+          documents PDF (uniquement avec <b>evince</b>), elle a un
+          historique des recherches complexes, et plein d'autres
+          petites am�liorations. Les <a href="release-1.18.html">notes
+            de version</a> (en anglais). <span class="important">Cette
+            version utilise <b>evince</b> par d�faut comme visualiseur
+            PDF m�me si recoll est configur� pour utiliser les
+            pr�f�rences du bureau. Vous pouvez retrouver le
+            comportement ant�rieur en �ditant la liste "exceptions"
+            dans la configuration GUI.</span>
+        </dd>
+
+        <dt>2012-10-25</dt><dd> Un probl�me avec une solution simple peut provoquer
           des <span class="important">plantages de
           recollindex</span>. 
           Si vous indexez des messages mail Mozilla/Thunderbird
           et � se planter. Dans les cas moins graves (avec des
           fichiers de taille "raisonnable"), cela provoque aussi une
           indexation incorrecte des messages.
-        </li>
+        </dd>
 
-        <li>2012-10-16: <a href="filters/filters.html">un nouveau filtre
-            pour les documents EPUB</a>.</li> 
-        <li>2012-05-24: Sortie de la
+<dt>2012-10-16</dt><dd> <a href="filters/filters.html">un nouveau filtre
+            pour les documents EPUB</a>.</dd> 
+<dt>2012-05-24</dt><dd> Sortie de la
           version <a href="download.html#source">1.17.3</a>. Voir
           les <a href="release-1.17.html">les notes</a>. Cette version
           corrige un "arr�t impr�vu" de l'indexation qui se produisait
           parfois en traitant certains messages mail.
-        </li>
+        </dd>
 
-        <li>2010-11-20 : un petit script pour activer/cacher recoll sur un
+        <dt>2010-11-20 : un petit script pour activer/cacher recoll sur un
           bureau gnome d'un seul coup de clavier: 
           <a href="http://bitbucket.org/medoc/recoll/wiki/HotRecoll">
-            recette d'installation</a>.</li>
+            recette d'installation</a>.</dd>
 
       </ul>
 

website/release-1.18.html

         character case and diacritics sensitivity, and it will be
         advisable to reset the index in most cases. This will be best
         done by destroying the index directory (<tt>rm -rf
-        ~/.recoll/xapiandb</tt>).</p>
-
-      <p><em>If</em> the 1.18 index is not configured for case and
+        ~/.recoll/xapiandb</tt>).<br>
+        <em>If</em> 1.18 is not configured for case and
         diacritics sensitivity, it is mostly compatible with 1.17
-        indexes though.</p>  
+        indexes.</p>
 
       <p>Case/diacritics sensitivity is off by default for this
         release. It can be turned on <em>only</em> by editing recoll.conf
-        (see the manual). If you do so, you must then reset the index.</p>
+        (<a href="usermanual/usermanual.html#RCL.INDEXING.CONFIG.SENS">
+          see the manual</a>). If you do so, you must then reset the index.</p>
 
       <p>Always reset the index if installing over an even older
         version (1.16 and older). The simplest way to do this is to
         (<span class="literal">rm&nbsp;-rf&nbsp;~/.recoll/xapiandb</span>),
         then start recoll or
         recollindex.  <span class="literal">recollindex&nbsp;-z</span>
-        will do the same in most, but not all, cases.</p>
+        &nbsp;will do the same in most, but not all, cases.</p>
 
       <p>The subdirectories of xapiandb which were previously used to
         store the stem expansion database (stem_english,
         which is the ability to search for exact matches of character case
         and diacritics.</p> 
 
-      <p>Recoll 1.18.0 changes:</p>
-
       <ul>
         
         <li>The index can now be configured for case and diacritics
           behave like they did in 1.17. Sensitivity must be
           explicitely requested in most cases.</li>
 
+        <li>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.</li> 
+
         <li>Recoll has a new capacity to store page break locations
           and use them when opening a document at the location for a
-          given match. This currently works with PDF, Postscript and DVI
-          documents, and the <b>evince</b> viewer.</li> 
+          given match. It will also pass a search string to the viewer
+          application. This currently works with PDF, Postscript and DVI
+          documents, and, optimally, the <b>evince</b> viewer.</li> 
 
-        <li>Recoll can now also pass a search string to the native
-          application (again, works with <b>evince</b>).</li> 
+        <li>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.</li>
 
         <li>There is a list of MIME types that should be opened with
           the locally configured application even when <em>Use
           be done from the <em>Preferences->Gui Configuration</em>
           menu.</li>
 
-        <li>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.</li>
-
-        <li>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.</li> 
-
         <li>We now allow multiple directory specifications in the query
           language, as in: <i>dir:/home/me -dir:tmp</i></li>
 

website/styles/style.css

     margin-right: 4em;
 }
 div.news {
-    font-size: 80%;
+    font-size: 90%;
+    margin-right: 5em;
 }
 .application {
     font-weight: bold;