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">
<html>
<head>
<title>Recoll download</title>
<head>
<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">
<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">
<body>
<link type="text/css" rel="stylesheet" href="styles/style.css">
</head>
<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>
<body>
<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">
<div class="content">
<h1>Recoll downloads</h1>
<h1>Recoll downloads</h1>
<div class="intrapage">
<div class="intrapage">
<table width=100%>
<tbody>
<tr>
<td><a href="#source">Source</a></td>
<td><a href="#packages">Packages (.rpm and .deb)</a></td>
<td><a href="BUGS.html">Known bugs</a></td>
<td><a href="#ports">Mac ports</a></td>
<td><a href="filters/filters.html">Filters</a> </td>
<td><a href="#translations">Translations</a></td>
</tr>
</tbody>
</table>
</div>
<table width="100%">
<tbody>
<tr>
<td><a href="#source">Source</a></td>
<td><a href="#packages">Packages (.rpm and .deb)</a></td>
<td><a href="BUGS.html">Known bugs</a></td>
<td><a href="#ports">Mac ports</a></td>
<td><a href="filters/filters.html">Filters</a> </td>
<td><a href="#translations">Translations</a></td>
</tr>
</tbody>
</table>
</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">
Release notes</a>.</p>
<p>The current version is 1.19.0. <a href="release-1.19.html">Release
notes</a>.</p>
<p>The download page for Recoll 1.17 is
<a href="download-1.17.html">still available</a>.</p>
<p>The download page for Recoll 1.18 is <a href="download-1.18.html">still
available</a>.</p>
<p>Recoll <a href="usermanual/rcl.install.html">
Installation / building manual</a>.</p>
<p>Recoll <a href="usermanual/rcl.install.html">Installation / building
manual</a>.</p>
<p>The indexing filters used for some document types may need
external packages not installed on your system by default, and
not installed automatically with Recoll: <a
href="features.html#doctypes"> take a look at the list</a> and
decide what you need to
install. Also <a href="filters/filters.html">new or updated
filters</a> sometimes become available after a release. As a
rule, all filters are compatible with all Recoll
versions. Any compatibility problem will be explicitely
mentionned.</p>
<p>The indexing filters used for some document types may need external packages
not installed on your system by default, and not installed automatically with
Recoll: <a href="features.html#doctypes">take a look at the list</a> and decide
what you need to install. Also <a href="filters/filters.html">new or updated
filters</a> sometimes become available after a release. As a 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
useful and optional) uses the <b>aspell</b> package, version
0.60 (utf-8 support) or newer.</p>
<p>The Recoll term explorer tool in phonetic mode (marginally useful and
optional) uses the <b>aspell</b> package, version 0.60 (utf-8 support) or
newer.</p>
<p>If you find problems with this page, the package or its
installation, <em>please</em> <a href="mailto:jfd@recoll.org">
report them</a>.</p>
<p>If you find problems with this page, the package or its installation,
<em>please</em> <a href="mailto:jfd@recoll.org">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
would only change for really major modifications like a big
change in the index format, and possibly won't ever reach
2.</p>
<p>The Recoll releases are numbered X.Y.Z. The X would only change for really
major modifications like a big change in the index format, and possibly won't
ever reach 2.</p>
<p>Y is for functional modifications. These may bring bugs, so
if you don't need the new features, you may want to wait a little,
and especially skip the first release (X.Y.0), at least for a few
weeks.</p>
<p>Y is for functional modifications. These may bring bugs, so if you don't
need the new features, you may want to wait a little, and especially skip the
first release (X.Y.0), at least for a few weeks.</p>
<p>Z changes for <a href="BUGS.html">bug fixes</a> only,
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="release-1.18.html">release file</a>), there is
probably no necessity to upgrade anyway.</p>
<p>Z changes for <a href="BUGS.html">bug fixes</a> only, 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="release-1.19.html">release file</a>), there
is 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>
<!-- 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.18.2.tar.gz">recoll-1.18.2.tar.gz</a>.
</p>
<h3>Current release distribution: 1.19.0:</h3>
<!-- Attention: source packages must remain here, not in a
subdirectory, because of all the places they're referred from
(package watches) -->
<!--
<h3>Snapshot</h3>
<p>I sometimes release a source tarfile when I consider that the
current development version is stable enough. The current
snapshot contains commits up to 2240 (see
<a href="https://bitbucket.org/medoc/recoll/changesets">the
changelog</a>, and a synthetic abstract in the
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>
-->
<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
current development version is stable enough. The current
snapshot contains commits up to 2240 (see
<a href="https://bitbucket.org/medoc/recoll/changesets">the
changelog</a>, and a synthetic abstract in the
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>
<ul>
<li>C++ compiler. Its absence sometimes manifests itself by
strange messages about iconv_open (fixed after 1.13.04).</li>
<h3>Prerequisites for building from source:</h3>
<ul>
<li>C++ compiler. Its absence sometimes manifests itself by strange messages
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
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>
<h3>Source repository:</h3>
<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&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>
<p>The <span class="application">Recoll</span> source repository is 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>
</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
will not build with Qt releases older than 4.4.</p></li>
<p>Packages or ports for Recoll are available in the standard repositories for
many distributions.</p>
<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>
<p>However they are often a bit older or built with older Xapian releases. Here
follow a number of updated packages and instructions for a number of
distributions.</p>
<li>Python development package: you can avoid needing this by
configuring with --disable-python-module.</li>
<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>
</ul>
<h3><a name="debian">Debian</a></h3>
<h3>Source repository:</h3>
<p>The <span class="application">Recoll</span> source repository is
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>
<p>The Debian Recoll packages are usually fairly up to date (at least in
testing), just use the appropriate Debian repository.</p>
<h3>Older recoll releases:</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>
<h3><a name="ubuntu">Ubuntu</a></h3>
<h2><a name="packages">Packages</a></h2>
<p>Packages or ports for Recoll are available in the standard
repositories for many distributions.</p>
<p>However they are often a bit older or built with older Xapian
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>
<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: </p>
<pre><tt>
sudo add-apt-repository ppa:recoll-backports/recoll-1.15-on
sudo apt-get update
sudo apt-get install recoll
</tt></pre>
</tt></pre>
<p>Source code for the lens (also included in the main
recoll tar file):<br>
For 1.18 installations: <a href="recoll-lens-1.18.1.2997.tar.gz">
recoll-lens-1.18.1.2997.tar.gz</a><br>
For 1.17: <a href="recoll-lens-1.17.2.2697.tar.gz">
recoll-lens-1.17.2.2697.tar.gz</a></p>
<p>Source code for the lens (also included in the main recoll tar file):<br>
For 1.19 installations: <a
href="recoll-lens-1.19.0.3315.tar.gz">recoll-lens-1.19.0.3315.tar.gz</a><br>
For 1.18: <a
href="recoll-lens-1.18.1.2997.tar.gz">recoll-lens-1.18.1.2997.tar.gz</a><br>
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
are a bit different in the sense that the Python extension
is included in the PPA package, but it's a separate
package in the standard repository. This can give rise to
errors about overwriting the Python module when switching
between versions. Typically, the error message would be
like the following:</p>
<pre><tt>
<p>The packages in the standard repository and on the PPA are a bit different
in the sense that the Python extension is included in the PPA package, but it's
a separate package in the standard repository. This can give rise to errors
about overwriting the Python module when switching between versions. Typically,
the error message would be 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>
<p>If this happens, you just need to delete
the previous package(s) before installing the other one(s)
instead of performing an upgrade.</p>
<blockquote>
<h4>Notes for Ubuntu Lucid</h4>
<p>If this happens, you just need to delete the previous package(s) before
installing the other one(s) instead of performing an upgrade.</p>
<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
<a href="https://launchpad.net/~xapian-backports/+archive/xapian-1.2">
Xapian backports PPA</a> to provide the <tt>libxapian22</tt>
package</li>
<h3><a name="mint">Linux Mint</a></h3>
<li>The <tt>rclepub</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>
<p>The Ubuntu PPA works perfectly for Mint 13 (and probably other releases
too). Just follow the instructions for Ubuntu.</p>
</ul>
</blockquote>
<h3>RPMS</h3>
<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
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>
<h3>Fedora</h3>
<p>Recoll is present in the standard Fedora package repositories
starting from F-12. The new versions are tracked quite
closely, so I don't build the rpms any more (email me if you need
one).</p>
<p>Recoll is present in the standard Fedora package repositories starting from
F-12. The new versions are tracked quite closely, so I don't build the rpms any
more (email me if you need one).</p>
<h3>OpenSUSE</h3>
<blockquote>
<p>Recoll is in the KDE:Extra repository
<h3>OpenSUSE</h3>
<!-- I now use the OpenSUSE build service to create Recoll
OpenSUSE packages. -->
You just need to add the repository to your
software sources (Yast2->software->Software repositories).<br>
<a href="http://download.opensuse.org/repositories/KDE:/Extra/">
Repository list (supported Suse versions)</a>. After adding the
appropriate repository to your software sources, you will be
able to install recoll and kio_recoll from the software
management interface. The Xapian dependancy will also be
satisfied 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>
</blockquote>
<blockquote>
<p>Recoll is in the KDE:Extra repository <!-- I now use the OpenSUSE build service to create Recoll
OpenSUSE packages. -->You just need to add the repository to your software
sources (Yast2-&gt;software-&gt;Software repositories).<br>
<a href="http://download.opensuse.org/repositories/KDE:/Extra/">Repository
list (supported Suse versions)</a>. After adding the appropriate repository
to your software sources, you will be able to install recoll and kio_recoll
from the software management interface. The Xapian dependancy will also be
satisfied 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>
</blockquote>
<h3>Mageia</h3>
<blockquote>
<h3>Mageia</h3>
<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="mageia2/recoll-1.18.1-1.mga2.src.rpm">
recoll-1.18.1-1.mga2.src.rpm</a>
</p>
</blockquote>
<blockquote>
<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><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="mageia2/recoll-1.18.1-1.mga2.src.rpm">recoll-1.18.1-1.mga2.src.rpm</a>
</p>
</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
misses (especially inside pdfs apparently, which is probably
more to the credit of 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>It seems that Recoll will sometimes find data that Spotlight misses
(especially inside pdfs apparently, which is probably more to the credit of
poppler than recoll itself).</p>
<p>Recoll is then available from the command line and as an icon in
the usual MacPorts applications place.</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>
<h2>Building on Solaris</h2>
<p>I did not test building the GUI on Solaris for this version. You
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>
<p>Recoll is then available from the command line and as an icon in the usual
MacPorts applications place.</p>
<h2><a name="translations">Translations</a></h2>
<h2>Building on Solaris</h2>
<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
the results to <a href="mailto:jfd@recoll.org">me</a> and earn
my gratefulness (and your less multilingual
compatriot's)...</p>
<p>I did not test building the GUI on Solaris for this version. You 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>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>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>
<p><a href="translations/recoll_xx.ts">recoll_xx.ts</a> is a blank
Recoll 1.18 message file, handy to work on a new translation.</p>
<h2><a name="translations">Translations</a></h2>
<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>
<p>Most of the translations for 1.19 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
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
release:</h3>
<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>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>
<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>
</div>
</body>
<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>
</div>
</body>
</html>

13
website/index.html.en
View File

@ -52,8 +52,8 @@
<li><a href="features.html">Detailed features</a>.
</ul>
<p>The current <span class="application">Recoll</span> version is
<a href="download.html">1.18.2</a>
(<a href="release-1.18.html">Release notes</a>,
<a href="download.html">1.19.0</a>
(<a href="release-1.19.html">Release notes</a>,
<a href="BUGS.html">known bugs</a>).</p>
<p><span class="application">Recoll</span> is based on the very
@ -87,12 +87,9 @@
<div class="news">
<dl>
<dt>2013-04-30</dt><dd>Recoll 1.19.0 will soon be out, and as
usual, there is a pre-release source tarfile for
adventurous souls who would be willing to test and
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>.
<dt>2013-05-12</dt><dd>Recoll 1.19.0 is out. See the
<a href="release-1.19.html">release notes</a> for a description
of the changes.</dd>
</dd>
<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
gratuit, dont le code source est disponible sous licence GPL.
La dernière version est
<a class="important" href="download.html">1.18.2</a>
(<a href="release-1.18.html">notes sur la version, en
<a class="important" href="download.html">1.19.0</a>
(<a href="release-1.19.html">notes sur la version, en
anglais</a>)</p>
<p>L'interface utilisateur de
@ -102,9 +102,7 @@
<h2>Nouvelles: </h2>
<dl>
<dt>2013-04-14</dt><dd>Release 1.18.2 corrige quelques
<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>2013-05-12</dt><dd>La version 1.19.0 est disponible.</dd>
<dt>2012-11-05</dt><dd>Recoll 1.18.1 est disponible. Cette
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">
<html>
<head>
<title>Recoll 1.19 series release notes</title>
<head>
<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">
<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">
<body>
<link type="text/css" rel="stylesheet" href="styles/style.css">
</head>
<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>
<body>
<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">
<div class="content">
<h1>Release notes for Recoll 1.19.x</h1>
<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>
<p>Always reset the index if you do not know by which version it was created
(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
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>Installing 1.19 over an 1.18 index will force a lot of reindexing anyway
because Recoll switched to using <i>st_ctime</i> instead of <i>st_mtime</i> to
detect file modifications, meaning that all files which were modified since
created will be updated.</p>
<p>Always reset the index if you do not know by which version it
was created (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&nbsp;-rf&nbsp;~/.recoll/xapiandb</span>),
then start recoll or recollindex. <br/>
<span class="literal">recollindex&nbsp;-z</span> &nbsp;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><span class="important">Viewer exceptions</span>: as in 1.18 (but we kept
this section for 1.17 users), there is a list of mime types that should be
opened with the locally configured application even when <em>Use Desktop
Preferences</em> is checked. This allows making use of new functions (direct
access to page), which could not be available through the desktop's
<tt>xdg-open</tt>. The default list contains PDF, Postscript and DVI, which
should be opened with the <em>evince</em> (or <em>atril</em> for Mint/MATE
users) viewer for the page access functions to work. If you want to keep the
previous behaviour (losing the page number functionality), you need to prune
the list after installation . This can be done from the <em>Preferences-&gt;Gui
Configuration</em> menu.</p>
<p>Installing 1.19 over an 1.18 index will force a lot of
reindexing anyway because Recoll switched from using st_ctime
instead of st_mtime to detect file modifications, meaning that
all files which were modified since created will be
updated.</p>
<p><span class="important">Viewer exceptions</span>: as in 1.18
(but we kept this section for 1.17 users),
there is a list of mime types that should be opened with
the locally configured application even when <em>Use
Desktop Preferences</em> is checked. This allows making
use of new functions (direct access to page), which could not
be available through the desktop's <tt>xdg-open</tt>. The
default list contains PDF, Postscript and DVI, which should be
opened with the <em>evince</em> (or <em>atril</em> for
Mint/MATE users) viewer for the page access functions to
work. If you want to keep the previous behaviour (losing the
page number functionality), you need to prune the list after
installation . This can be done from the <em>Preferences->Gui
Configuration</em> menu.</p>
<h2>Changes in Recoll 1.19.0</h2>
<ul>
<li>Indexing can use multiple threads. This can be a
major performance boost for people with multiprocessor
machines and big indexes. The threads setup is
roughly auto-configured when recollindex starts, based on
the number of processors, but it is also possible to taylor
it in the configuration. Here are some
<a href="http://www.recoll.org/idxthreads/threadingRecoll.html">
notes about the transformation and the performance
improvements</a>. There is also a
<a href="http://www.recoll.org/usermanual/usermanual.html#RCL.INSTALL.CONFIG.RECOLLCONF.IDXTHREADS">
section in the manual</a> to describe the configuration.
</li>
<li>There is a new result list/table popup menu option to
display all the sub-documents for a given one. This is
mostly useful to display the attachments to an email. The
resulting screen can be used to save a multiple selection of
the entries to files.</li>
<li>It is now possible to use OR with "dir:" clauses, and
wildcards have been enabled.</li>
<li>When the option to follow symbolic links is not set
-which is the default- symbolic links are now indexed as
such (name and content).</li>
<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 auto-completion inside the simple search
string. The completion was often more confusing and ennoying than
useful, especially because it is case-insensitive when case
sometimes matter for Recoll searches (capitalization to
disable stemming).</li>
<li>When the option to collapse identical results is used,
documents which do have duplicates are shown with a
link to list the clones. This function needs new data from
the index, so it will only completely work after a full 1.19
reindex.</li>
<li>Recoll should now behave reasonably on video files: index
the name and propose an Open button in the result list to
start the configured player.</li>
<li>Thanks to Recoll
user <a href="https://github.com/koniu">Koniu</a>, you can now
access your Recoll indexes through a Web
browser interface. The server side is based on
the <a href="http://bottlepy.org/docs/dev/">Bottle Python
Web framework</a> and the Recoll Python module, and can run
self-contained (no necessity to run apache or another web
server), so it's quite simple to set up. See:
See the <a href="https://github.com/koniu/recoll-webui/">
Recoll WebUI project</a> on GitHub. </li>
<li>Thanks to Recoll user David, there is now a filter to
index and retrieve <b>Lotus Notes</b> messages. See the
software
<a href="http://sourceforge.net/projects/rcollnotesfiltr/">
site on sourceforge</a> and some
<a href="http://richardappleby.wordpress.com/2013/04/11/you-dont-have-to-know-the-answer-to-everything-just-how-to-find-it/">
notes</a> from a user with a slightly different
configuration.</li>
<li>There is a new path translation facility, with a GUI
interface, to make it easier to share an index from a network
share on clients on which the mount points might be
different. This could also probably be put to use to design
a "portable index" feature (for removable media).</li>
<li>The first indexing run after Recoll installation (for a new
user) will run in a fashion which will put data likely to be
useful into the index faster, so that an impatient user can
more quickly try searches.</li>
<li>Implemented cache for last file uncompressed. This will
much improve usage, e.g. for people fetching successive
messages from a compressed mail folder.</li>
<li>Recollindex will now change its current directory to a
temporary one (e.g. /tmp) to mitigate the problems of some
filters creating temporary files and not cleaning them.</li>
<li>There is a new recursive reindex option to command line
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>
<h2>Changes in Recoll 1.19.0</h2>
<ul>
<li>Indexing can use multiple threads. This can be a major performance boost
for people with multiprocessor machines and big indexes. The threads setup
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
is a <a
href="http://www.recoll.org/usermanual/usermanual.html#RCL.INSTALL.CONFIG.RECOLLCONF.IDXTHREADS">section
in the manual</a> to describe the configuration, and also some <a
href="http://www.recoll.org/idxthreads/threadingRecoll.html">notes about
the transformation and the performance improvements</a>. </li>
<li>There is a new result list/table popup menu option to display all the
sub-documents for a given one. This is mostly useful to display the
attachments to an email. The resulting screen can be used to select
multiple entries and save them to files.</li>
<li>It is now possible to use OR with "dir:" clauses, and wildcards have been
enabled.</li>
<li>When the option to follow symbolic links is not set -which is the
default- symbolic links are now indexed as such (name and content).</li>
<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
auto-completion inside the simple search string. The completion was often
more confusing and ennoying than useful, especially because it is
case-insensitive when case sometimes matter for Recoll searches
(capitalization to disable stemming).</li>
<li>When the option to collapse identical results is used, documents which do
have duplicates are shown with a link to list the clones. This function
needs new data from the index, so it will only completely work after a full
1.19 reindex.</li>
<li>Recoll should now behave reasonably on video files: index the name and
propose an Open button in the result list to start the configured
player.</li>
<li>Thanks to Recoll user <a href="https://github.com/koniu">Koniu</a>, you
can now access your Recoll indexes through a Web browser interface. The
server side is based on the <a href="http://bottlepy.org/docs/dev/">Bottle
Python Web framework</a> and the Recoll Python module, and can run
self-contained (no necessity to run apache or another web server), so it's
quite simple to set up. See: See the <a
href="https://github.com/koniu/recoll-webui/">Recoll WebUI project</a> on
GitHub. </li>
<li>Thanks to Recoll user David, there is now a filter to index and retrieve
<b>Lotus Notes</b> messages. See the software <a
href="http://sourceforge.net/projects/rcollnotesfiltr/">site on
sourceforge</a> and some <a
href="http://richardappleby.wordpress.com/2013/04/11/you-dont-have-to-know-the-answer-to-everything-just-how-to-find-it/">notes</a>
from a user with a slightly different configuration.</li>
<li>There is a new path translation facility, with a GUI interface, to make
it easier to share an index from a network share on clients on which the
mount points might be different. This could also probably be put to use to
design a "portable index" feature (for removable media).</li>
<li>The first indexing run after Recoll installation (for a new user) will
run in a fashion which will put data likely to be useful into the index
faster, so that an impatient user can more quickly try searches.</li>
<li>Implemented cache for last file uncompressed. This will much improve
usage, e.g. for people fetching successive messages from a compressed mail
folder.</li>
<li>Recollindex will now change its current directory to a temporary one
(e.g. /tmp) to mitigate the problems of some filters creating temporary
files and not cleaning them.</li>
<li>There is a new recursive explicit reindex option to the command line
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-&gt;GUI
configuration-&gt;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 also 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>