tris/recoll
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

doc

Browse Source
This commit is contained in:
Jean-Francois Dockes 2013-05-12 11:19:31 +02:00
parent 9715c36f52
commit 555d209708
5 changed files with 1189 additions and 1488 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

1686
website/BUGS.html
View File

File diff suppressed because it is too large Load Diff

583
website/download.html
View File

@ -1,382 +1,337 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html> <html>
<head> <head>
<title>Recoll download</title> <title>Recoll download</title>
<meta name="Author" content="Jean-Francois Dockes">
<meta name="Description"
content="recoll is a simple full-text search system for unix and linux based on the powerful and mature xapian engine">
<meta name="Keywords" content="full text search, desktop search, unix, linux">
<meta http-equiv="Content-language" content="en">
<meta http-equiv="content-type" content="text/html; charset=iso-8859-1">
<meta name="robots" content="All,Index,Follow">
<link type="text/css" rel="stylesheet" href="styles/style.css">
</head>
<meta name="generator" content="HTML Tidy, see www.w3.org"> <body>
<meta name="Author" content="Jean-Francois Dockes">
<meta name="Description" content=
"recoll is a simple full-text search system for unix and linux
based on the powerful and mature xapian engine">
<meta name="Keywords" content=
"full text search, desktop search, unix, linux">
<meta http-equiv="Content-language" content="en">
<meta http-equiv="content-type" content="text/html; charset=iso-8859-1">
<meta name="robots" content="All,Index,Follow">
<link type="text/css" rel="stylesheet" href="styles/style.css"> <div class="rightlinks">
</head> <ul>
<li><a href="index.html">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="index.html#support">Support</a></li>
</ul>
</div>
<body> <div class="content">
<h1>Recoll downloads</h1>
<div class="rightlinks">
<ul>
<li><a href="index.html">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="index.html#support">Support</a></li>
</ul>
</div>
<div class="content">
<h1>Recoll downloads</h1> <div class="intrapage">
<div class="intrapage"> <table width="100%">
<table width=100%> <tbody>
<tbody> <tr>
<tr> <td><a href="#source">Source</a></td>
<td><a href="#source">Source</a></td> <td><a href="#packages">Packages (.rpm and .deb)</a></td>
<td><a href="#packages">Packages (.rpm and .deb)</a></td> <td><a href="BUGS.html">Known bugs</a></td>
<td><a href="BUGS.html">Known bugs</a></td> <td><a href="#ports">Mac ports</a></td>
<td><a href="#ports">Mac ports</a></td> <td><a href="filters/filters.html">Filters</a> </td>
<td><a href="filters/filters.html">Filters</a> </td> <td><a href="#translations">Translations</a></td>
<td><a href="#translations">Translations</a></td> </tr>
</tr> </tbody>
</tbody> </table>
</table> </div>
</div>
<h2><a>General information</a></h2> <h2><a>General information</a></h2>
<p>The current version is 1.18.2. <a href="release-1.18.html"> <p>The current version is 1.19.0. <a href="release-1.19.html">Release
Release notes</a>.</p> notes</a>.</p>
<p>The download page for Recoll 1.17 is <p>The download page for Recoll 1.18 is <a href="download-1.18.html">still
<a href="download-1.17.html">still available</a>.</p> available</a>.</p>
<p>Recoll <a href="usermanual/rcl.install.html"> <p>Recoll <a href="usermanual/rcl.install.html">Installation / building
Installation / building manual</a>.</p> manual</a>.</p>
<p>The indexing filters used for some document types may need <p>The indexing filters used for some document types may need external packages
external packages not installed on your system by default, and not installed on your system by default, and not installed automatically with
not installed automatically with Recoll: <a Recoll: <a href="features.html#doctypes">take a look at the list</a> and decide
href="features.html#doctypes"> take a look at the list</a> and what you need to install. Also <a href="filters/filters.html">new or updated
decide what you need to filters</a> sometimes become available after a release. As a rule, all filters
install. Also <a href="filters/filters.html">new or updated are compatible with all Recoll versions. Any compatibility problem will be
filters</a> sometimes become available after a release. As a explicitely mentionned.</p>
rule, all filters are compatible with all Recoll
versions. Any compatibility problem will be explicitely
mentionned.</p>
<p>The Recoll term explorer tool in phonetic mode (marginally <p>The Recoll term explorer tool in phonetic mode (marginally useful and
useful and optional) uses the <b>aspell</b> package, version optional) uses the <b>aspell</b> package, version 0.60 (utf-8 support) or
0.60 (utf-8 support) or newer.</p> newer.</p>
<p>If you find problems with this page, the package or its <p>If you find problems with this page, the package or its installation,
installation, <em>please</em> <a href="mailto:jfd@recoll.org"> <em>please</em> <a href="mailto:jfd@recoll.org">report them</a>.</p>
report them</a>.</p>
<h4>What do the release numbers mean?</h4> <h4>What do the release numbers mean?</h4>
<p>The Recoll releases are numbered X.Y.Z. The X <p>The Recoll releases are numbered X.Y.Z. The X would only change for really
would only change for really major modifications like a big major modifications like a big change in the index format, and possibly won't
change in the index format, and possibly won't ever reach ever reach 2.</p>
2.</p>
<p>Y is for functional modifications. These may bring bugs, so <p>Y is for functional modifications. These may bring bugs, so if you don't
if you don't need the new features, you may want to wait a little, need the new features, you may want to wait a little, and especially skip the
and especially skip the first release (X.Y.0), at least for a few first release (X.Y.0), at least for a few weeks.</p>
weeks.</p>
<p>Z changes for <a href="BUGS.html">bug fixes</a> only, <p>Z changes for <a href="BUGS.html">bug fixes</a> only, and moving from X.Y.Z
and moving from X.Y.Z to X.Y.Z+u should in general involve to X.Y.Z+u should in general involve little risk of regression. But,
little risk of regression. But, <em>any</em> change can bring <em>any</em> change can bring problems, if you are not affected by the
problems, if you are not affected by the corrected bugs (check corrected bugs (check the <a href="release-1.19.html">release file</a>), there
the <a href="release-1.18.html">release file</a>), there is is probably no necessity to upgrade anyway.</p>
probably no necessity to upgrade anyway.</p>
<h2><a name="source">Source</a></h2> <h2><a name="source">Source</a></h2>
<h3>Current release distribution: 1.18.2:</h3> <h3>Current release distribution: 1.19.0:</h3>
<!-- Attention: source packages must remain here, not in a <!-- Attention: source packages must remain here, not in a
subdirectory, because of all the places they're referred from subdirectory, because of all the places they're referred from
(package watches) --> (package watches) -->
<p><a href="recoll-1.18.2.tar.gz">recoll-1.18.2.tar.gz</a>.
</p>
<!-- <p><a href="recoll-1.19.0.tar.gz">recoll-1.19.0.tar.gz</a>. </p>
<h3>Snapshot</h3> <!--
<p>I sometimes release a source tarfile when I consider that the <h3>Snapshot</h3>
current development version is stable enough. The current <p>I sometimes release a source tarfile when I consider that the
snapshot contains commits up to 2240 (see current development version is stable enough. The current
<a href="https://bitbucket.org/medoc/recoll/changesets">the snapshot contains commits up to 2240 (see
changelog</a>, and a synthetic abstract in the <a href="https://bitbucket.org/medoc/recoll/changesets">the
current <a href="release-1.16.html">1.16 release notes</a>). changelog</a>, and a synthetic abstract in the
<p><a href="betarecoll-2240.tar.gz">betarecoll-2240.tar.gz</a>.</p> current <a href="release-1.16.html">1.16 release notes</a>).
--> <p><a href="betarecoll-2240.tar.gz">betarecoll-2240.tar.gz</a>.</p>
-->
<h3>Prerequisites for building from source:</h3> <h3>Prerequisites for building from source:</h3>
<ul> <ul>
<li>C++ compiler. Its absence sometimes manifests itself by <li>C++ compiler. Its absence sometimes manifests itself by strange messages
strange messages about iconv_open (fixed after 1.13.04).</li> about iconv_open (fixed after 1.13.04).</li>
<li><p>Xapian core development libraries. Most Linux distributions carry them
in their package repository. Or you will find source and binary packages on
the <a href="http://www.xapian.org/download.php">Xapian download page</a>.
<br>
Recoll should still work with Xapian 1.0, but it is highly recommended to
use a Xapian 1.2 version.</p>
<p><em>Note on building Xapian for older CPUs:</em> The build
configurations for Xapian releases 1.0.21 and 1.2.1 or newer enable the use
of SSE2 floating point instructions. These instructions are not available
in CPUs older than Intel Pentium 4 or AMD Athlon 64. When building for such
a CPU, you need to add the --disable-sse flag to the Xapian library
configure command. If this is not done, the problem signals itself by
"Illegal instruction" crashes (SIGILL) in recollindex and recoll. </p>
</li>
<li>X11 development files.</li>
<li>zlib development files.</li>
<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 --help).</p>
</li>
<li>Python development package: you can avoid needing this by configuring
with --disable-python-module.</li>
</ul>
<li><p>Xapian core development libraries. Most Linux distributions <h3>Source repository:</h3>
carry them in their package repository. Or you will find source and
binary packages on the
<a href="http://www.xapian.org/download.php">
Xapian download page</a>. <br />
Recoll should still work with Xapian 1.0, but it is highly
recommended to use a Xapian 1.2 version.</p>
<p><em>Note on building Xapian for older CPUs:</em> The <p>The <span class="application">Recoll</span> source repository is hosted on
build configurations for Xapian releases 1.0.21 and <a href="http://bitbucket.org/medoc/recoll/overview">bitbucket.org</a>. The
1.2.1 or newer enable the use of SSE2 floating point trunk is usually a bit on the bleeding edge, but there is always a maintenance
instructions. These instructions are not available in CPUs branch for the current production version.</p>
older than Intel Pentium&nbsp;4 or AMD Athlon&nbsp;64. When
building for such a CPU, you need to add the --disable-sse
flag to the Xapian library configure command. If this is
not done, the problem signals itself by "Illegal
instruction" crashes (SIGILL) in recollindex and recoll.
</p>
</li> <h3>Older recoll releases:</h3>
<li>X11 development files.</li> <p><a href="recoll-1.18.2.tar.gz">1.18.2</a>. <a
href="recoll-1.18.1.tar.gz">1.18.1</a>. <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>. <a
href="recoll-1.13.04.tar.gz">1.13.04</a>. <a
href="older/recoll-1.12.4.tar.gz">1.12.4</a>. <a
href="older/recoll-1.11.4.tar.gz">1.11.4</a>. <a
href="older/recoll-1.10.6.tar.gz">1.10.6</a>. <a
href="older/recoll-1.9.0.tar.gz">1.9.0</a>. <a
href="older/recoll-1.8.2.tar.gz">1.8.2</a>. <a
href="older/recoll-1.7.6.tar.gz">1.7.6</a>. <a
href="older/recoll-1.6.3.tar.gz">1.6.3</a>. <a
href="older/recoll-1.5.11.tar.gz">1.5.11</a>. <a
href="older/recoll-1.4.3.tar.gz">1.4.3</a>. <a
href="older/recoll-1.3.3.tar.gz">1.3.3</a>. <a
href="older/recoll-1.2.3.tar.gz">1.2.3</a>. <a
href="older/recoll-1.1.0.tar.gz">1.1.0</a>. <a
href="older/recoll-1.0.16.tar.gz">1.0.16</a>. </p>
<li>zlib development files.</li> <h2><a name="packages">Packages</a></h2>
<li><p>Qt development files: Qt 4.4 or newer. The Recoll GUI <p>Packages or ports for Recoll are available in the standard repositories for
will not build with Qt releases older than 4.4.</p></li> many distributions.</p>
<li><p>Qt webkit development: Qt WebKit is quite often <p>However they are often a bit older or built with older Xapian releases. Here
distributed apart from the main Qt lib. It is possible to follow a number of updated packages and instructions for a number of
configure Recoll not to use Qt WebKit (see distributions.</p>
configure&nbsp;--help).</p></li>
<li>Python development package: you can avoid needing this by <p>All binary packages on this page need a Qt 4 (4.4 at least) runtime
configuring with --disable-python-module.</li> environment. To make things easier, on systems where Xapian is not available
from the standard package repositories, the Recoll package will have a static
link to Xapian so that you do not need to build/install it separately.</p>
</ul> <h3><a name="debian">Debian</a></h3>
<h3>Source repository:</h3> <p>The Debian Recoll packages are usually fairly up to date (at least in
<p>The <span class="application">Recoll</span> source repository is testing), just use the appropriate Debian repository.</p>
hosted on
<a href="http://bitbucket.org/medoc/recoll/overview">bitbucket.org</a>.
The trunk is usually a bit on the bleeding edge, but there is
always a maintenance branch for the current production version.</p>
<h3>Older recoll releases:</h3> <h3><a name="ubuntu">Ubuntu</a></h3>
<p>
<a href="recoll-1.18.1.tar.gz">1.18.1</a>.
<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>.
<a href="recoll-1.13.04.tar.gz">1.13.04</a>.
<a href="recoll-1.12.4.tar.gz">1.12.4</a>.
<a href="recoll-1.11.4.tar.gz">1.11.4</a>.
<a href="recoll-1.10.6.tar.gz">1.10.6</a>.
<a href="recoll-1.9.0.tar.gz">1.9.0</a>.
<a href="older/recoll-1.8.2.tar.gz">1.8.2</a>.
<a href="older/recoll-1.7.6.tar.gz">1.7.6</a>.
<a href="older/recoll-1.6.3.tar.gz">1.6.3</a>.
<a href="older/recoll-1.5.11.tar.gz">1.5.11</a>.
<a href="older/recoll-1.4.3.tar.gz">1.4.3</a>.
<a href="older/recoll-1.3.3.tar.gz">1.3.3</a>.
<a href="older/recoll-1.2.3.tar.gz">1.2.3</a>.
<a href="older/recoll-1.1.0.tar.gz">1.1.0</a>.
<a href="older/recoll-1.0.16.tar.gz">1.0.16</a>.
</p>
<h2><a name="packages">Packages</a></h2> <p>There are Personal Package Archives on launchpad.net for <a
href="https://launchpad.net/~recoll-backports/+archive/recoll-1.15-on">Recoll,
<p>Packages or ports for Recoll are available in the standard kio-recoll and recoll-lens</a>. These were built from the latest versions, for
repositories for many distributions.</p> a set of Ubuntu series. starting at Lucid. The installation is very simple: </p>
<p>However they are often a bit older or built with older Xapian <pre><tt>
releases. Here follow a number of updated packages and
instructions for a number of distributions.</p>
<p>All binary packages on this page need a Qt 4 (4.4 at least) runtime
environment. To make things easier, on systems where Xapian is
not available from the standard package repositories, the
Recoll package will have a static link to Xapian so that you
do not need to build/install it separately.</p>
<h3><a name="debian">Debian</a></h3>
<p>The Debian Recoll packages are usually fairly up to date (at
least in testing), just use the appropriate Debian repository.</p>
<h3><a name="ubuntu">Ubuntu</a></h3>
<p>There are Personal Package Archives on launchpad.net for
<a href="https://launchpad.net/~recoll-backports/+archive/recoll-1.15-on">
Recoll, kio-recoll and recoll-lens</a>. These were built from the
latest versions, for a set of Ubuntu series. starting at
Lucid. The installation is very simple:
<pre><tt>
sudo add-apt-repository ppa:recoll-backports/recoll-1.15-on sudo add-apt-repository ppa:recoll-backports/recoll-1.15-on
sudo apt-get update sudo apt-get update
sudo apt-get install recoll sudo apt-get install recoll
</tt></pre> </tt></pre>
<p>Source code for the lens (also included in the main <p>Source code for the lens (also included in the main recoll tar file):<br>
recoll tar file):<br> For 1.19 installations: <a
For 1.18 installations: <a href="recoll-lens-1.18.1.2997.tar.gz"> href="recoll-lens-1.19.0.3315.tar.gz">recoll-lens-1.19.0.3315.tar.gz</a><br>
recoll-lens-1.18.1.2997.tar.gz</a><br> For 1.18: <a
For 1.17: <a href="recoll-lens-1.17.2.2697.tar.gz"> href="recoll-lens-1.18.1.2997.tar.gz">recoll-lens-1.18.1.2997.tar.gz</a><br>
recoll-lens-1.17.2.2697.tar.gz</a></p> For 1.17: <a
href="recoll-lens-1.17.2.2697.tar.gz">recoll-lens-1.17.2.2697.tar.gz</a></p>
<p>The packages in the standard repository and on the PPA <p>The packages in the standard repository and on the PPA are a bit different
are a bit different in the sense that the Python extension in the sense that the Python extension is included in the PPA package, but it's
is included in the PPA package, but it's a separate a separate package in the standard repository. This can give rise to errors
package in the standard repository. This can give rise to about overwriting the Python module when switching between versions. Typically,
errors about overwriting the Python module when switching the error message would be like the following:</p>
between versions. Typically, the error message would be <pre><tt>
like the following:</p>
<pre><tt>
ErrorMessage: trying to overwrite '/usr/lib/python2.7/dist-packages/recoll.so', which is also in package recoll 1.18.1-1~ppa1~quantal1</tt></pre> ErrorMessage: trying to overwrite '/usr/lib/python2.7/dist-packages/recoll.so', which is also in package recoll 1.18.1-1~ppa1~quantal1</tt></pre>
<p>If this happens, you just need to delete <p>If this happens, you just need to delete the previous package(s) before
the previous package(s) before installing the other one(s) installing the other one(s) instead of performing an upgrade.</p>
instead of performing an upgrade.</p>
<blockquote>
<h4>Notes for Ubuntu Lucid</h4>
<ul> <blockquote>
<h4>Notes for Ubuntu Lucid</h4>
<ul>
<li>If you use Ubuntu 10.04 (<em>Lucid</em>), you will need to add the <a
href="https://launchpad.net/~xapian-backports/+archive/xapian-1.2">Xapian
backports PPA</a> to provide the <tt>libxapian22</tt> package</li>
<li>The <tt><code>rclepub</code></tt> filter apparently needs <tt>Python
2.7</tt>. You will need to install it and modify the first line of the
filter script to execute <tt>python2.7</tt> instead of
<tt>python</tt>.</li>
</ul>
</blockquote>
<li>Under lucid you will need to add the <h3><a name="mint">Linux Mint</a></h3>
<a href="https://launchpad.net/~xapian-backports/+archive/xapian-1.2">
Xapian backports PPA</a> to provide the <tt>libxapian22</tt>
package</li>
<li>The <tt>rclepub</tt> filter apparently needs <tt>Python <p>The Ubuntu PPA works perfectly for Mint 13 (and probably other releases
2.7</tt>. You will need to install it and modify the first too). Just follow the instructions for Ubuntu.</p>
line of the filter script to execute <tt>python2.7</tt>
instead of <tt>python</tt>.</li>
</ul> <h3>RPMS</h3>
</blockquote>
<h3><a name="mint">Linux Mint</a></h3> <p>You'll need to install the Xapian, Qt, Qt-Webkit and zlib development
packages if you want use the source rpms.</p>
<p>The Ubuntu PPA works perfectly for Mint 13 (and probably <h3>Fedora</h3>
other releases too). Just follow the instructions for Ubuntu.</p>
<h3>RPMS</h3>
<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 repositories <p>Recoll is present in the standard Fedora package repositories starting from
starting from F-12. The new versions are tracked quite F-12. The new versions are tracked quite closely, so I don't build the rpms any
closely, so I don't build the rpms any more (email me if you need more (email me if you need one).</p>
one).</p>
<h3>OpenSUSE</h3> <h3>OpenSUSE</h3>
<blockquote>
<p>Recoll is in the KDE:Extra repository
<!-- I now use the OpenSUSE build service to create Recoll <blockquote>
OpenSUSE packages. --> <p>Recoll is in the KDE:Extra repository <!-- I now use the OpenSUSE build service to create Recoll
You just need to add the repository to your OpenSUSE packages. -->You just need to add the repository to your software
software sources (Yast2->software->Software repositories).<br> sources (Yast2-&gt;software-&gt;Software repositories).<br>
<a href="http://download.opensuse.org/repositories/KDE:/Extra/"> <a href="http://download.opensuse.org/repositories/KDE:/Extra/">Repository
Repository list (supported Suse versions)</a>. After adding the list (supported Suse versions)</a>. After adding the appropriate repository
appropriate repository to your software sources, you will be to your software sources, you will be able to install recoll and kio_recoll
able to install recoll and kio_recoll from the software from the software management interface. The Xapian dependancy will also be
management interface. The Xapian dependancy will also be satisfied from the build service repository. Some of the older repositories
satisfied from the build service repository. Some of the older do not build antiword, just tell the software manager to "break" recoll by
repositories do not build antiword, just tell the software manager installing anyway, and get antiword somewhere else.</p>
to "break" recoll by installing anyway, and get antiword </blockquote>
somewhere else.</p>
</blockquote>
<h3>Mageia</h3> <h3>Mageia</h3>
<blockquote>
<p>Mageia version 2: <blockquote>
<a href="mageia2/recoll-1.18.1-1.mga2.i586.rpm"> <p>Mageia version 2: <a
mageia2/recoll-1.18.1-1.mga2.i586.rpm, 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"> </a><a
recoll-debug-1.18.1-1.mga2.i586.rpm</a>. <br> href="mageia2/recoll-debug-1.18.1-1.mga2.i586.rpm">recoll-debug-1.18.1-1.mga2.i586.rpm</a>.
Source: <br>
<a href="mageia2/recoll-1.18.1-1.mga2.src.rpm"> Source: <a
recoll-1.18.1-1.mga2.src.rpm</a> href="mageia2/recoll-1.18.1-1.mga2.src.rpm">recoll-1.18.1-1.mga2.src.rpm</a>
</p> </p>
</blockquote> </blockquote>
<h2><a name="ports">Ports</a></h2> <h2><a name="ports">Ports</a></h2>
<h3>Mac port</h3> <h3>Mac port</h3>
<p>It seems that Recoll will sometimes find data that Spotlight <p>It seems that Recoll will sometimes find data that Spotlight misses
misses (especially inside pdfs apparently, which is probably (especially inside pdfs apparently, which is probably more to the credit of
more to the credit of poppler than recoll itself).</p> poppler than recoll itself).</p>
<p>Recoll is in MacPorts and really easy to install:</p>
<ol>
<li><a href="https://trac.macports.org/wiki/InstallingMacPorts">
Install MacPorts</a>.</li>
<li>Type "sudo port install recoll"</li>
</ol>
<p>Recoll is then available from the command line and as an icon in <p>Recoll is in MacPorts and really easy to install:</p>
the usual MacPorts applications place.</p> <ol>
<li><a href="https://trac.macports.org/wiki/InstallingMacPorts">Install
MacPorts</a>.</li>
<li>Type "sudo port install recoll"</li>
</ol>
<h2>Building on Solaris</h2> <p>Recoll is then available from the command line and as an icon in the usual
<p>I did not test building the GUI on Solaris for this version. You MacPorts applications place.</p>
will need at least Qt 4.4. The old hints
in <a href="download-1.14.html">the previous page</a> may
still be valid.</p>
<p>Someone did test the indexer and Python module build, they
do work, with a few minor glitches. Be sure to use
GNU <b>make</b> and <b>install</b>.</p>
<h2><a name="translations">Translations</a></h2> <h2>Building on Solaris</h2>
<p>Most of the translations for 1.18 are incomplete <p>I did not test building the GUI on Solaris for this version. You will need
The source translation files are included in the source at least Qt 4.4. The old hints in <a href="download-1.14.html">the previous
release. If your language has some english messages left and page</a> may still be valid.</p>
you want to take a shot at fixing the problem, you can send
the results to <a href="mailto:jfd@recoll.org">me</a> and earn
my gratefulness (and your less multilingual
compatriot's)...</p>
<p>You can use the <em>.ts</em> file to alter the translations if you <p>Someone did test the indexer and Python module build, they do work, with a
wish (use Qt's <em>linguist</em> tool to edit the source file, few minor glitches. Be sure to use GNU <b>make</b> and <b>install</b>.</p>
then <em>lrelease</em> to produce the <em>.qm</em> file.).
The <literal>.qm</literal> file should be copied to
<span class="filename">/usr/[local/]share/recoll/translations</span>
</p>
<p><a href="translations/recoll_xx.ts">recoll_xx.ts</a> is a blank <h2><a name="translations">Translations</a></h2>
Recoll 1.18 message file, handy to work on a new translation.</p>
<p>A Czech translation for 1.18, thanks to Pavel <p>Most of the translations for 1.19 are incomplete The source translation
<a href="translations/recoll_cs.ts">recoll_cs.ts</a> files are included in the source release. If your language has some english
<a href="translations/recoll_cs.qm">recoll_cs.qm</a> messages left and you want to take a shot at fixing the problem, you can send
</p> the results to <a href="mailto:jfd@recoll.org">me</a> and earn my gratefulness
(and your less multilingual compatriot's)...</p>
<p>You can use the <em>.ts</em> file to alter the translations if you wish (use
Qt's <em>linguist</em> tool to edit the source file, then <em>lrelease</em> to
produce the <em>.qm</em> file.). The <literal>.qm</literal>file should be
copied to <span class="filename">/usr/[local/]share/recoll/translations</span>
</p>
<p><a href="translations/recoll_xx.ts">recoll_xx.ts</a> is a blank Recoll 1.19
message file, handy to work on a new translation.</p>
<!-- <!--
<h3>Updated 1.18 translations that became available after the <h3>Updated 1.18 translations that became available after the
release:</h3> release:</h3>
<p>A Greek translation for 1.17, thanks to Dimitrios <p>A Czech translation for 1.18, thanks to Pavel
<a href="translations/recoll_el.ts">recoll_el.ts</a> <a href="translations/recoll_cs.ts">recoll_cs.ts</a>
<a href="translations/recoll_el.qm">recoll_el.qm</a> <a href="translations/recoll_cs.qm">recoll_cs.qm</a>
</p> </p>
<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>Note that, if you are running an older release, you may find updated
</div> messages by looking inside the appropriate maintenance branch on <a
</body> href="https://bitbucket.org/medoc/recoll/src">bitbucket</a>.</p>
</div>
</body>
</html> </html>

13
website/index.html.en
View File

@ -52,8 +52,8 @@
<li><a href="features.html">Detailed features</a>. <li><a href="features.html">Detailed features</a>.
</ul> </ul>
<p>The current <span class="application">Recoll</span> version is <p>The current <span class="application">Recoll</span> version is
<a href="download.html">1.18.2</a> <a href="download.html">1.19.0</a>
(<a href="release-1.18.html">Release notes</a>, (<a href="release-1.19.html">Release notes</a>,
<a href="BUGS.html">known bugs</a>).</p> <a href="BUGS.html">known bugs</a>).</p>
<p><span class="application">Recoll</span> is based on the very <p><span class="application">Recoll</span> is based on the very
@ -87,12 +87,9 @@
<div class="news"> <div class="news">
<dl> <dl>
<dt>2013-04-30</dt><dd>Recoll 1.19.0 will soon be out, and as <dt>2013-05-12</dt><dd>Recoll 1.19.0 is out. See the
usual, there is a pre-release source tarfile for <a href="release-1.19.html">release notes</a> for a description
adventurous souls who would be willing to test and of the changes.</dd>
help the release to be as close to flawless as
possible. The <a href="betarecoll-3304.tar.gz">tar file</a> and the
the <a href="release-1.19.html">release notes</a>.
</dd> </dd>
<dt>2013-04-30</dt><dd>Thanks to some of its users, Recoll now <dt>2013-04-30</dt><dd>Thanks to some of its users, Recoll now

8
website/index.html.fr
View File

@ -48,8 +48,8 @@
<p><span class="application">Recoll</span> est un logiciel libre <p><span class="application">Recoll</span> est un logiciel libre
gratuit, dont le code source est disponible sous licence GPL. gratuit, dont le code source est disponible sous licence GPL.
La dernière version est La dernière version est
<a class="important" href="download.html">1.18.2</a> <a class="important" href="download.html">1.19.0</a>
(<a href="release-1.18.html">notes sur la version, en (<a href="release-1.19.html">notes sur la version, en
anglais</a>)</p> anglais</a>)</p>
<p>L'interface utilisateur de <p>L'interface utilisateur de
@ -102,9 +102,7 @@
<h2>Nouvelles: </h2> <h2>Nouvelles: </h2>
<dl> <dl>
<dt>2013-04-14</dt><dd>Release 1.18.2 corrige quelques <dt>2013-05-12</dt><dd>La version 1.19.0 est disponible.</dd>
<a href="BUGS.html#b_1_18_1">problèmes mineurs de la version
1.18.1</a>. Elle ne sera pas distribuée sous forme binaire.</dd>
<dt>2012-11-05</dt><dd>Recoll 1.18.1 est disponible. Cette <dt>2012-11-05</dt><dd>Recoll 1.18.1 est disponible. Cette
version peut faire des recherches sensibles aux majuscules et version peut faire des recherches sensibles aux majuscules et

387
website/release-1.19.html
View File

@ -1,240 +1,173 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html> <html>
<head> <head>
<title>Recoll 1.19 series release notes</title> <title>Recoll 1.19 series release notes</title>
<meta name="Author" content="Jean-Francois Dockes">
<meta name="Description"
content="recoll is a simple full-text search system for unix and linux based on the powerful and mature xapian engine">
<meta name="Keywords" content="full text search, desktop search, unix, linux">
<meta http-equiv="Content-language" content="en">
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
<meta name="robots" content="All,Index,Follow">
<link type="text/css" rel="stylesheet" href="styles/style.css">
</head>
<meta name="generator" content="HTML Tidy, see www.w3.org"> <body>
<meta name="Author" content="Jean-Francois Dockes">
<meta name="Description" content=
"recoll is a simple full-text search system for unix and linux
based on the powerful and mature xapian engine">
<meta name="Keywords" content=
"full text search, desktop search, unix, linux">
<meta http-equiv="Content-language" content="en">
<meta http-equiv="content-type" content="text/html; charset=utf-8">
<meta name="robots" content="All,Index,Follow">
<link type="text/css" rel="stylesheet" href="styles/style.css"> <div class="rightlinks">
</head> <ul>
<li><a href="index.html">Home</a></li>
<li><a href="download.html">Downloads</a></li>
<li><a href="doc.html">Documentation</a></li>
</ul>
</div>
<body> <div class="content">
<h1>Release notes for Recoll 1.19.x</h1>
<div class="rightlinks">
<ul>
<li><a href="index.html">Home</a></li>
<li><a href="download.html">Downloads</a></li>
<li><a href="doc.html">Documentation</a></li>
</ul>
</div>
<div class="content">
<h1>Release notes for Recoll 1.19.x</h1> <h2>Caveats</h2>
<p><em>Installing over an older version</em>: 1.19 </p>
<h2>Caveats</h2> <p>Case/diacritics sensitivity is still off by default for this release. It can
be turned on <em>only</em> by editing recoll.conf (<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><em>Installing over an older version</em>: 1.19 <p>Always reset the index if you do not know by which version it was created
</p> (you're not sure it's 1.18). The simplest way to do this is to quit all Recoll
programs and just delete the index directory (<span
class="literal">rm -rf ~/.recoll/xapiandb</span>), then start
<code>recoll</code> or <code>recollindex</code>. <br>
<span class="literal">recollindex -z</span>  will do the same in most, but
not all, cases. It's better to use the <tt>rm</tt> method, which will also
ensure that no debris from older releases remain (e.g.: old stemming files
which are not used any more).</p>
<p>Case/diacritics sensitivity is still off by default for this <p>Installing 1.19 over an 1.18 index will force a lot of reindexing anyway
release. It can be turned on <em>only</em> by editing recoll.conf because Recoll switched to using <i>st_ctime</i> instead of <i>st_mtime</i> to
(<a href="usermanual/usermanual.html#RCL.INDEXING.CONFIG.SENS"> detect file modifications, meaning that all files which were modified since
see the manual</a>). If you do so, you must then reset the index.</p> created will be updated.</p>
<p>Always reset the index if you do not know by which version it <p><span class="important">Viewer exceptions</span>: as in 1.18 (but we kept
was created (you're not sure it's 1.18). The simplest way to this section for 1.17 users), there is a list of mime types that should be
do this is to quit all recoll programs and just delete the opened with the locally configured application even when <em>Use Desktop
index directory Preferences</em> is checked. This allows making use of new functions (direct
(<span class="literal">rm&nbsp;-rf&nbsp;~/.recoll/xapiandb</span>), access to page), which could not be available through the desktop's
then start recoll or recollindex. <br/> <tt>xdg-open</tt>. The default list contains PDF, Postscript and DVI, which
<span class="literal">recollindex&nbsp;-z</span> &nbsp;will do should be opened with the <em>evince</em> (or <em>atril</em> for Mint/MATE
the same in most, but not all, cases. It's better to use users) viewer for the page access functions to work. If you want to keep the
the <tt>rm</tt> method, which will also ensure that no debris previous behaviour (losing the page number functionality), you need to prune
from older releases remain (e.g.: old stemming files which are the list after installation . This can be done from the <em>Preferences-&gt;Gui
not used any more).</p> Configuration</em> menu.</p>
<p>Installing 1.19 over an 1.18 index will force a lot of <h2>Changes in Recoll 1.19.0</h2>
reindexing anyway because Recoll switched from using st_ctime <ul>
instead of st_mtime to detect file modifications, meaning that <li>Indexing can use multiple threads. This can be a major performance boost
all files which were modified since created will be for people with multiprocessor machines and big indexes. The threads setup
updated.</p> is roughly auto-configured when recollindex starts, based on the number of
processors, but it is also possible to taylor it in the configuration.There
<p><span class="important">Viewer exceptions</span>: as in 1.18 is a <a
(but we kept this section for 1.17 users), href="http://www.recoll.org/usermanual/usermanual.html#RCL.INSTALL.CONFIG.RECOLLCONF.IDXTHREADS">section
there is a list of mime types that should be opened with in the manual</a> to describe the configuration, and also some <a
the locally configured application even when <em>Use href="http://www.recoll.org/idxthreads/threadingRecoll.html">notes about
Desktop Preferences</em> is checked. This allows making the transformation and the performance improvements</a>. </li>
use of new functions (direct access to page), which could not <li>There is a new result list/table popup menu option to display all the
be available through the desktop's <tt>xdg-open</tt>. The sub-documents for a given one. This is mostly useful to display the
default list contains PDF, Postscript and DVI, which should be attachments to an email. The resulting screen can be used to select
opened with the <em>evince</em> (or <em>atril</em> for multiple entries and save them to files.</li>
Mint/MATE users) viewer for the page access functions to <li>It is now possible to use OR with "dir:" clauses, and wildcards have been
work. If you want to keep the previous behaviour (losing the enabled.</li>
page number functionality), you need to prune the list after <li>When the option to follow symbolic links is not set -which is the
installation . This can be done from the <em>Preferences->Gui default- symbolic links are now indexed as such (name and content).</li>
Configuration</em> menu.</p> <li>There are new GUI configuration options to run in "search as you type"
mode (which I don't find useful at all...), and to disable the Qt
<h2>Changes in Recoll 1.19.0</h2> auto-completion inside the simple search string. The completion was often
more confusing and ennoying than useful, especially because it is
<ul> case-insensitive when case sometimes matter for Recoll searches
(capitalization to disable stemming).</li>
<li>Indexing can use multiple threads. This can be a <li>When the option to collapse identical results is used, documents which do
major performance boost for people with multiprocessor have duplicates are shown with a link to list the clones. This function
machines and big indexes. The threads setup is needs new data from the index, so it will only completely work after a full
roughly auto-configured when recollindex starts, based on 1.19 reindex.</li>
the number of processors, but it is also possible to taylor <li>Recoll should now behave reasonably on video files: index the name and
it in the configuration. Here are some propose an Open button in the result list to start the configured
<a href="http://www.recoll.org/idxthreads/threadingRecoll.html"> player.</li>
notes about the transformation and the performance <li>Thanks to Recoll user <a href="https://github.com/koniu">Koniu</a>, you
improvements</a>. There is also a can now access your Recoll indexes through a Web browser interface. The
<a href="http://www.recoll.org/usermanual/usermanual.html#RCL.INSTALL.CONFIG.RECOLLCONF.IDXTHREADS"> server side is based on the <a href="http://bottlepy.org/docs/dev/">Bottle
section in the manual</a> to describe the configuration. Python Web framework</a> and the Recoll Python module, and can run
</li> self-contained (no necessity to run apache or another web server), so it's
quite simple to set up. See: See the <a
<li>There is a new result list/table popup menu option to href="https://github.com/koniu/recoll-webui/">Recoll WebUI project</a> on
display all the sub-documents for a given one. This is GitHub. </li>
mostly useful to display the attachments to an email. The <li>Thanks to Recoll user David, there is now a filter to index and retrieve
resulting screen can be used to save a multiple selection of <b>Lotus Notes</b> messages. See the software <a
the entries to files.</li> href="http://sourceforge.net/projects/rcollnotesfiltr/">site on
sourceforge</a> and some <a
<li>It is now possible to use OR with "dir:" clauses, and href="http://richardappleby.wordpress.com/2013/04/11/you-dont-have-to-know-the-answer-to-everything-just-how-to-find-it/">notes</a>
wildcards have been enabled.</li> from a user with a slightly different configuration.</li>
<li>There is a new path translation facility, with a GUI interface, to make
<li>When the option to follow symbolic links is not set it easier to share an index from a network share on clients on which the
-which is the default- symbolic links are now indexed as mount points might be different. This could also probably be put to use to
such (name and content).</li> design a "portable index" feature (for removable media).</li>
<li>The first indexing run after Recoll installation (for a new user) will
<li>There are new GUI configuration options to run in "search run in a fashion which will put data likely to be useful into the index
as you type" mode (which I don't find useful at all...), and faster, so that an impatient user can more quickly try searches.</li>
to disable the Qt auto-completion inside the simple search <li>Implemented cache for last file uncompressed. This will much improve
string. The completion was often more confusing and ennoying than usage, e.g. for people fetching successive messages from a compressed mail
useful, especially because it is case-insensitive when case folder.</li>
sometimes matter for Recoll searches (capitalization to <li>Recollindex will now change its current directory to a temporary one
disable stemming).</li> (e.g. /tmp) to mitigate the problems of some filters creating temporary
files and not cleaning them.</li>
<li>When the option to collapse identical results is used, <li>There is a new recursive explicit reindex option to the command line
documents which do have duplicates are shown with a indexer.</li>
link to list the clones. This function needs new data from <li>The default result list paragraph format has been slightly tweaked
the index, so it will only completely work after a full 1.19 (removed the relevance percentage and small ordering and formatting
reindex.</li> changes).</li>
<li>Mime type wildcard expansion is now performed against the index, not the
<li>Recoll should now behave reasonably on video files: index configuration. This fixes many problems when searching for, e.g., media
the name and propose an Open button in the result list to files indexed only by name.</li>
start the configured player.</li> <li>The choice for case/diacritics sensitivity is now fully processed during
wildcard expansion (for case-sensitive indexes).</li>
<li>Thanks to Recoll <li>The Snippets popup (list of pages and excerpts typically produced for PDF
user <a href="https://github.com/koniu">Koniu</a>, you can now documents) can now use an external CSS stylesheet. This is useful because
access your Recoll indexes through a Web the Qt Webkit objects do not fully inherit the Qt configuration so that,
browser interface. The server side is based on for example, a style sheet is needed for using a different background
the <a href="http://bottlepy.org/docs/dev/">Bottle Python color. The style sheet is chosen from the <tt>Preferences-&gt;GUI
Web framework</a> and the Recoll Python module, and can run configuration-&gt;Result list</tt> panel.</li>
self-contained (no necessity to run apache or another web <li>Improved handling of filters during indexing resulting in less
server), so it's quite simple to set up. See: subprocesses.</li>
See the <a href="https://github.com/koniu/recoll-webui/"> <li>Added function to import tags from external application (e.g. Tmsu).</li>
Recoll WebUI project</a> on GitHub. </li> <li>Changed format for rclaptg field. Was colon-separated, now uses normal
value/attributes syntax with an empty value like:
<li>Thanks to Recoll user David, there is now a filter to <pre> localfields = ; attr1 = val1 ; attr2 = val2
index and retrieve <b>Lotus Notes</b> messages. See the </pre>
software </li>
<a href="http://sourceforge.net/projects/rcollnotesfiltr/"> <li>Extended file attributes are now indexed by default. As a side effect,
site on sourceforge</a> and some recoll now uses st_ctime, not st_mtime to detect file changes. This means
<a href="http://richardappleby.wordpress.com/2013/04/11/you-dont-have-to-know-the-answer-to-everything-just-how-to-find-it/"> that installing 1.19 will reindex many files (all those that were modified
notes</a> from a user with a slightly different since created). Recoll also now processes the <tt>charset</tt> and
configuration.</li> <tt>mime_type</tt> standardized extended attributes.</li>
<li>The Python module has been expanded to include the interface for
<li>There is a new path translation facility, with a GUI extracting data. This means that you could now write most of the Recoll GUI
interface, to make it easier to share an index from a network in Python if you wished. There is a <a
share on clients on which the mount points might be href="https://bitbucket.org/medoc/recoll/src/5b4bd9ef26a1/src/python/samples/recollgui/qrecoll.py?at=default">bit
different. This could also probably be put to use to design of sample code</a> in the source package doing just this. A few
a "portable index" feature (for removable media).</li> incompatible changes had to be made to the Python module. Especially the
"Query.next" field is gone and the module structure has been changed
<li>The first indexing run after Recoll installation (for a new (different import statement needed). Adapting your code is trivial, have a
user) will run in a fashion which will put data likely to be look at the changes in the <a
useful into the index faster, so that an impatient user can href="https://bitbucket.org/medoc/recoll/src/5b4bd9ef26a10912bf8bd833fe6c084bd5a7bdbd/src/desktop/unity-lens-recoll/recollscope/rclsearch.py?at=default">Unity
more quickly try searches.</li> Lens module</a> for an example. The new module is compatible with the <a
href="http://www.python.org/dev/peps/pep-0249/">Python Database API
<li>Implemented cache for last file uncompressed. This will Specification v2.0</a> for the parts that make sense for a non-relational
much improve usage, e.g. for people fetching successive DB.</li>
messages from a compressed mail folder.</li> <li>Recoll now uses a dynamic library for the code shared by the query
interface, the indexer and the Python module. This should have no visible
<li>Recollindex will now change its current directory to a impact but was rendered necessary by the Python module evolutions.</li>
temporary one (e.g. /tmp) to mitigate the problems of some <li>And quite a few <a href="BUGS.html#b_1_18_2">Fixed bugs</a></li>
filters creating temporary files and not cleaning them.</li> </ul>
</div>
<li>There is a new recursive reindex option to command line </body>
indexer.</li>
<li>The default result list paragraph format has been slightly
tweaked (removed the relevance percentage and small ordering
and formatting changes).</li>
<li>Mime type wildcard expansion is now performed against the
index, not the configuration. This fixes many problems when
searching for, e.g., media files indexed only by name.</li>
<li>The choice for case/diacritics sensitivity is now fully
processed during wildcard expansion (for case-sensitive
indexes).</li>
<li>The Snippets popup (list of pages and excerpts typically
produced for PDF documents) can now use an external
CSS stylesheet. This is useful because the Qt Webkit
objects do not fully inherit the Qt configuration so that,
for example, a style sheet is needed for using
a different background color. The style sheet is chosen
from the <tt>Preferences->GUI configuration->Result
list</tt> panel.</li>
<li>Improved handling of filters during indexing resulting in
less subprocesses.</li>
<li>Added function to import tags from external application
(e.g. Tmsu).</li>
<li>Changed format for rclaptg field. Was colon-separated,
now uses normal value/attributes syntax with an empty value
like:
<pre>
localfields = ; attr1 = val1 ; attr2 = val2
</pre>
</li>
<li>Extended file attributes are now indexed by default. As a
side effect, recoll now uses st_ctime, not st_mtime to detect
file changes. This means that installing 1.19 will reindex
many files (all those that were modified since created).
Recoll now processes the <tt>charset</tt>
and <tt>mime_type</tt> standardized extended attributes.</li>
<li>The Python module has been expanded to include the
interface for extracting data. This means that you could now
write most of the Recoll GUI in Python if you wished. There
is
a <a href="https://bitbucket.org/medoc/recoll/src/5b4bd9ef26a1/src/python/samples/recollgui/qrecoll.py?at=default">bit
of sample code</a> in the source package doing just this. A
few incompatible changes had to be made to the Python
module. Especially the "Query.next" field is gone and the
module structure has been changed (different import
statement needed). Adapting your code is trivial, have a
look at the changes in
the <a href="https://bitbucket.org/medoc/recoll/src/5b4bd9ef26a10912bf8bd833fe6c084bd5a7bdbd/src/desktop/unity-lens-recoll/recollscope/rclsearch.py?at=default">Unity
Lens module</a> for an example. The new module is compatible
with
the <a href="http://www.python.org/dev/peps/pep-0249/">Python
Database API Specification v2.0</a> for the parts that make
sense for a non-relational DB.</li>
<li>Recoll now uses a dynamic library for the code shared by
the query interface, the indexer and the Python
module. This should have no visible impact but was rendered
necessary by the Python module evolutions.</li>
<li>And quite a few <a href="BUGS.html#b_1_18_2">Fixed bugs</a></li>
</ul>
</div>
</body>
</html> </html>