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

581
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"> <div class="intrapage">
<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"> <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>
<h1>Recoll downloads</h1> <h2><a>General information</a></h2>
<div class="intrapage"> <p>The current version is 1.19.0. <a href="release-1.19.html">Release
<table width=100%> notes</a>.</p>
<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> <p>The download page for Recoll 1.18 is <a href="download-1.18.html">still
available</a>.</p>
<p>The current version is 1.18.2. <a href="release-1.18.html"> <p>Recoll <a href="usermanual/rcl.install.html">Installation / building
Release notes</a>.</p> manual</a>.</p>
<p>The download page for Recoll 1.17 is <p>The indexing filters used for some document types may need external packages
<a href="download-1.17.html">still available</a>.</p> 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>Recoll <a href="usermanual/rcl.install.html"> <p>The Recoll term explorer tool in phonetic mode (marginally useful and
Installation / building manual</a>.</p> optional) uses the <b>aspell</b> package, version 0.60 (utf-8 support) or
newer.</p>
<p>The indexing filters used for some document types may need <p>If you find problems with this page, the package or its installation,
external packages not installed on your system by default, and <em>please</em> <a href="mailto:jfd@recoll.org">report them</a>.</p>
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 <h4>What do the release numbers mean?</h4>
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 <p>The Recoll releases are numbered X.Y.Z. The X would only change for really
installation, <em>please</em> <a href="mailto:jfd@recoll.org"> major modifications like a big change in the index format, and possibly won't
report them</a>.</p> ever reach 2.</p>
<h4>What do the release numbers mean?</h4> <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>The Recoll releases are numbered X.Y.Z. The X <p>Z changes for <a href="BUGS.html">bug fixes</a> only, and moving from X.Y.Z
would only change for really major modifications like a big to X.Y.Z+u should in general involve little risk of regression. But,
change in the index format, and possibly won't ever reach <em>any</em> change can bring problems, if you are not affected by the
2.</p> corrected bugs (check the <a href="release-1.19.html">release file</a>), there
is probably no necessity to upgrade anyway.</p>
<p>Y is for functional modifications. These may bring bugs, so <h2><a name="source">Source</a></h2>
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, <h3>Current release distribution: 1.19.0:</h3>
and moving from X.Y.Z to X.Y.Z+u should in general involve <!-- Attention: source packages must remain here, not in a
little risk of regression. But, <em>any</em> change can bring subdirectory, because of all the places they're referred from
problems, if you are not affected by the corrected bugs (check (package watches) -->
the <a href="release-1.18.html">release file</a>), there is
probably no necessity to upgrade anyway.</p>
<h2><a name="source">Source</a></h2> <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>Current release distribution: 1.18.2:</h3> <h3>Prerequisites for building from source:</h3>
<!-- Attention: source packages must remain here, not in a <ul>
subdirectory, because of all the places they're referred from <li>C++ compiler. Its absence sometimes manifests itself by strange messages
(package watches) --> about iconv_open (fixed after 1.13.04).</li>
<p><a href="recoll-1.18.2.tar.gz">recoll-1.18.2.tar.gz</a>. <li><p>Xapian core development libraries. Most Linux distributions carry them
</p> 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>
<!-- <h3>Source repository:</h3>
<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> <p>The <span class="application">Recoll</span> source repository is hosted on
<ul> <a href="http://bitbucket.org/medoc/recoll/overview">bitbucket.org</a>. The
<li>C++ compiler. Its absence sometimes manifests itself by trunk is usually a bit on the bleeding edge, but there is always a maintenance
strange messages about iconv_open (fixed after 1.13.04).</li> branch for the current production version.</p>
<li><p>Xapian core development libraries. Most Linux distributions <h3>Older recoll releases:</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><a href="recoll-1.18.2.tar.gz">1.18.2</a>. <a
build configurations for Xapian releases 1.0.21 and href="recoll-1.18.1.tar.gz">1.18.1</a>. <a
1.2.1 or newer enable the use of SSE2 floating point href="recoll-1.17.3.tar.gz">1.17.3</a>. <a
instructions. These instructions are not available in CPUs href="recoll-1.16.2.tar.gz">1.16.2</a>. <a
older than Intel Pentium&nbsp;4 or AMD Athlon&nbsp;64. When href="recoll-1.15.9.tar.gz">1.15.9</a>. <a
building for such a CPU, you need to add the --disable-sse href="recoll-1.14.4.tar.gz">1.14.4</a>. <a
flag to the Xapian library configure command. If this is href="recoll-1.13.04.tar.gz">1.13.04</a>. <a
not done, the problem signals itself by "Illegal href="older/recoll-1.12.4.tar.gz">1.12.4</a>. <a
instruction" crashes (SIGILL) in recollindex and recoll. href="older/recoll-1.11.4.tar.gz">1.11.4</a>. <a
</p> 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> <h2><a name="packages">Packages</a></h2>
<li>X11 development files.</li> <p>Packages or ports for Recoll are available in the standard repositories for
many distributions.</p>
<li>zlib development files.</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><p>Qt development files: Qt 4.4 or newer. The Recoll GUI <p>All binary packages on this page need a Qt 4 (4.4 at least) runtime
will not build with Qt releases older than 4.4.</p></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>
<li><p>Qt webkit development: Qt WebKit is quite often <h3><a name="debian">Debian</a></h3>
distributed apart from the main Qt lib. It is possible to
configure Recoll not to use Qt WebKit (see
configure&nbsp;--help).</p></li>
<li>Python development package: you can avoid needing this by <p>The Debian Recoll packages are usually fairly up to date (at least in
configuring with --disable-python-module.</li> testing), just use the appropriate Debian repository.</p>
</ul> <h3><a name="ubuntu">Ubuntu</a></h3>
<h3>Source repository:</h3> <p>There are Personal Package Archives on launchpad.net for <a
<p>The <span class="application">Recoll</span> source repository is href="https://launchpad.net/~recoll-backports/+archive/recoll-1.15-on">Recoll,
hosted on kio-recoll and recoll-lens</a>. These were built from the latest versions, for
<a href="http://bitbucket.org/medoc/recoll/overview">bitbucket.org</a>. a set of Ubuntu series. starting at Lucid. The installation is very simple: </p>
The trunk is usually a bit on the bleeding edge, but there is <pre><tt>
always a maintenance branch for the current production version.</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>
<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>
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> <blockquote>
<h4>Notes for Ubuntu Lucid</h4> <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>
<ul> <h3><a name="mint">Linux Mint</a></h3>
<li>Under lucid you will need to add the <p>The Ubuntu PPA works perfectly for Mint 13 (and probably other releases
<a href="https://launchpad.net/~xapian-backports/+archive/xapian-1.2"> too). Just follow the instructions for Ubuntu.</p>
Xapian backports PPA</a> to provide the <tt>libxapian22</tt>
package</li>
<li>The <tt>rclepub</tt> filter apparently needs <tt>Python <h3>RPMS</h3>
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> <p>You'll need to install the Xapian, Qt, Qt-Webkit and zlib development
</blockquote> packages if you want use the source rpms.</p>
<h3><a name="mint">Linux Mint</a></h3> <h3>Fedora</h3>
<p>The Ubuntu PPA works perfectly for Mint 13 (and probably <p>Recoll is present in the standard Fedora package repositories starting from
other releases too). Just follow the instructions for Ubuntu.</p> 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>RPMS</h3> <h3>OpenSUSE</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> <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>
<p>Recoll is present in the standard Fedora package repositories <h3>Mageia</h3>
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>
<blockquote> <p>Mageia version 2: <a
<p>Recoll is in the KDE:Extra repository 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>
<!-- I now use the OpenSUSE build service to create Recoll <h2><a name="ports">Ports</a></h2>
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>
<h3>Mageia</h3> <h3>Mac port</h3>
<blockquote>
<p>Mageia version 2: <p>It seems that Recoll will sometimes find data that Spotlight misses
<a href="mageia2/recoll-1.18.1-1.mga2.i586.rpm"> (especially inside pdfs apparently, which is probably more to the credit of
mageia2/recoll-1.18.1-1.mga2.i586.rpm, poppler than recoll itself).</p>
<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> <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>
<h3>Mac port</h3> <p>Recoll is then available from the command line and as an icon in the usual
MacPorts applications place.</p>
<p>It seems that Recoll will sometimes find data that Spotlight <h2>Building on Solaris</h2>
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>Recoll is then available from the command line and as an icon in <p>I did not test building the GUI on Solaris for this version. You will need
the usual MacPorts applications place.</p> at least Qt 4.4. The old hints in <a href="download-1.14.html">the previous
page</a> may still be valid.</p>
<h2>Building on Solaris</h2> <p>Someone did test the indexer and Python module build, they do work, with a
<p>I did not test building the GUI on Solaris for this version. You few minor glitches. Be sure to use GNU <b>make</b> and <b>install</b>.</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><a name="translations">Translations</a></h2>
<p>Most of the translations for 1.18 are incomplete <p>Most of the translations for 1.19 are incomplete The source translation
The source translation files are included in the source files are included in the source release. If your language has some english
release. If your language has some english messages left and messages left and you want to take a shot at fixing the problem, you can send
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
the results to <a href="mailto:jfd@recoll.org">me</a> and earn (and your less multilingual compatriot's)...</p>
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>You can use the <em>.ts</em> file to alter the translations if you wish (use
wish (use Qt's <em>linguist</em> tool to edit the source file, Qt's <em>linguist</em> tool to edit the source file, then <em>lrelease</em> to
then <em>lrelease</em> to produce the <em>.qm</em> file.). produce the <em>.qm</em> file.). The <literal>.qm</literal>file should be
The <literal>.qm</literal> file should be copied to copied to <span class="filename">/usr/[local/]share/recoll/translations</span>
<span class="filename">/usr/[local/]share/recoll/translations</span> </p>
</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>
<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 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"> <h2>Caveats</h2>
<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"> <p><em>Installing over an older version</em>: 1.19 </p>
<h1>Release notes for Recoll 1.19.x</h1> <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>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>
<h2>Caveats</h2> <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><em>Installing over an older version</em>: 1.19 <p><span class="important">Viewer exceptions</span>: as in 1.18 (but we kept
</p> 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>Case/diacritics sensitivity is still off by default for this <h2>Changes in Recoll 1.19.0</h2>
release. It can be turned on <em>only</em> by editing recoll.conf <ul>
(<a href="usermanual/usermanual.html#RCL.INDEXING.CONFIG.SENS"> <li>Indexing can use multiple threads. This can be a major performance boost
see the manual</a>). If you do so, you must then reset the index.</p> for people with multiprocessor machines and big indexes. The threads setup
is roughly auto-configured when recollindex starts, based on the number of
<p>Always reset the index if you do not know by which version it processors, but it is also possible to taylor it in the configuration.There
was created (you're not sure it's 1.18). The simplest way to is a <a
do this is to quit all recoll programs and just delete the href="http://www.recoll.org/usermanual/usermanual.html#RCL.INSTALL.CONFIG.RECOLLCONF.IDXTHREADS">section
index directory in the manual</a> to describe the configuration, and also some <a
(<span class="literal">rm&nbsp;-rf&nbsp;~/.recoll/xapiandb</span>), href="http://www.recoll.org/idxthreads/threadingRecoll.html">notes about
then start recoll or recollindex. <br/> the transformation and the performance improvements</a>. </li>
<span class="literal">recollindex&nbsp;-z</span> &nbsp;will do <li>There is a new result list/table popup menu option to display all the
the same in most, but not all, cases. It's better to use sub-documents for a given one. This is mostly useful to display the
the <tt>rm</tt> method, which will also ensure that no debris attachments to an email. The resulting screen can be used to select
from older releases remain (e.g.: old stemming files which are multiple entries and save them to files.</li>
not used any more).</p> <li>It is now possible to use OR with "dir:" clauses, and wildcards have been
enabled.</li>
<p>Installing 1.19 over an 1.18 index will force a lot of <li>When the option to follow symbolic links is not set -which is the
reindexing anyway because Recoll switched from using st_ctime default- symbolic links are now indexed as such (name and content).</li>
instead of st_mtime to detect file modifications, meaning that <li>There are new GUI configuration options to run in "search as you type"
all files which were modified since created will be mode (which I don't find useful at all...), and to disable the Qt
updated.</p> auto-completion inside the simple search string. The completion was often
more confusing and ennoying than useful, especially because it is
<p><span class="important">Viewer exceptions</span>: as in 1.18 case-insensitive when case sometimes matter for Recoll searches
(but we kept this section for 1.17 users), (capitalization to disable stemming).</li>
there is a list of mime types that should be opened with <li>When the option to collapse identical results is used, documents which do
the locally configured application even when <em>Use have duplicates are shown with a link to list the clones. This function
Desktop Preferences</em> is checked. This allows making needs new data from the index, so it will only completely work after a full
use of new functions (direct access to page), which could not 1.19 reindex.</li>
be available through the desktop's <tt>xdg-open</tt>. The <li>Recoll should now behave reasonably on video files: index the name and
default list contains PDF, Postscript and DVI, which should be propose an Open button in the result list to start the configured
opened with the <em>evince</em> (or <em>atril</em> for player.</li>
Mint/MATE users) viewer for the page access functions to <li>Thanks to Recoll user <a href="https://github.com/koniu">Koniu</a>, you
work. If you want to keep the previous behaviour (losing the can now access your Recoll indexes through a Web browser interface. The
page number functionality), you need to prune the list after server side is based on the <a href="http://bottlepy.org/docs/dev/">Bottle
installation . This can be done from the <em>Preferences->Gui Python Web framework</a> and the Recoll Python module, and can run
Configuration</em> menu.</p> self-contained (no necessity to run apache or another web server), so it's
quite simple to set up. See: See the <a
<h2>Changes in Recoll 1.19.0</h2> href="https://github.com/koniu/recoll-webui/">Recoll WebUI project</a> on
GitHub. </li>
<ul> <li>Thanks to Recoll user David, there is now a filter to index and retrieve
<b>Lotus Notes</b> messages. See the software <a
<li>Indexing can use multiple threads. This can be a href="http://sourceforge.net/projects/rcollnotesfiltr/">site on
major performance boost for people with multiprocessor sourceforge</a> and some <a
machines and big indexes. The threads setup is href="http://richardappleby.wordpress.com/2013/04/11/you-dont-have-to-know-the-answer-to-everything-just-how-to-find-it/">notes</a>
roughly auto-configured when recollindex starts, based on from a user with a slightly different configuration.</li>
the number of processors, but it is also possible to taylor <li>There is a new path translation facility, with a GUI interface, to make
it in the configuration. Here are some it easier to share an index from a network share on clients on which the
<a href="http://www.recoll.org/idxthreads/threadingRecoll.html"> mount points might be different. This could also probably be put to use to
notes about the transformation and the performance design a "portable index" feature (for removable media).</li>
improvements</a>. There is also a <li>The first indexing run after Recoll installation (for a new user) will
<a href="http://www.recoll.org/usermanual/usermanual.html#RCL.INSTALL.CONFIG.RECOLLCONF.IDXTHREADS"> run in a fashion which will put data likely to be useful into the index
section in the manual</a> to describe the configuration. faster, so that an impatient user can more quickly try searches.</li>
</li> <li>Implemented cache for last file uncompressed. This will much improve
usage, e.g. for people fetching successive messages from a compressed mail
<li>There is a new result list/table popup menu option to folder.</li>
display all the sub-documents for a given one. This is <li>Recollindex will now change its current directory to a temporary one
mostly useful to display the attachments to an email. The (e.g. /tmp) to mitigate the problems of some filters creating temporary
resulting screen can be used to save a multiple selection of files and not cleaning them.</li>
the entries to files.</li> <li>There is a new recursive explicit reindex option to the command line
indexer.</li>
<li>It is now possible to use OR with "dir:" clauses, and <li>The default result list paragraph format has been slightly tweaked
wildcards have been enabled.</li> (removed the relevance percentage and small ordering and formatting
changes).</li>
<li>When the option to follow symbolic links is not set <li>Mime type wildcard expansion is now performed against the index, not the
-which is the default- symbolic links are now indexed as configuration. This fixes many problems when searching for, e.g., media
such (name and content).</li> files indexed only by name.</li>
<li>The choice for case/diacritics sensitivity is now fully processed during
<li>There are new GUI configuration options to run in "search wildcard expansion (for case-sensitive indexes).</li>
as you type" mode (which I don't find useful at all...), and <li>The Snippets popup (list of pages and excerpts typically produced for PDF
to disable the Qt auto-completion inside the simple search documents) can now use an external CSS stylesheet. This is useful because
string. The completion was often more confusing and ennoying than the Qt Webkit objects do not fully inherit the Qt configuration so that,
useful, especially because it is case-insensitive when case for example, a style sheet is needed for using a different background
sometimes matter for Recoll searches (capitalization to color. The style sheet is chosen from the <tt>Preferences-&gt;GUI
disable stemming).</li> configuration-&gt;Result list</tt> panel.</li>
<li>Improved handling of filters during indexing resulting in less
<li>When the option to collapse identical results is used, subprocesses.</li>
documents which do have duplicates are shown with a <li>Added function to import tags from external application (e.g. Tmsu).</li>
link to list the clones. This function needs new data from <li>Changed format for rclaptg field. Was colon-separated, now uses normal
the index, so it will only completely work after a full 1.19 value/attributes syntax with an empty value like:
reindex.</li> <pre> localfields = ; attr1 = val1 ; attr2 = val2
</pre>
<li>Recoll should now behave reasonably on video files: index </li>
the name and propose an Open button in the result list to <li>Extended file attributes are now indexed by default. As a side effect,
start the configured player.</li> 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
<li>Thanks to Recoll since created). Recoll also now processes the <tt>charset</tt> and
user <a href="https://github.com/koniu">Koniu</a>, you can now <tt>mime_type</tt> standardized extended attributes.</li>
access your Recoll indexes through a Web <li>The Python module has been expanded to include the interface for
browser interface. The server side is based on extracting data. This means that you could now write most of the Recoll GUI
the <a href="http://bottlepy.org/docs/dev/">Bottle Python in Python if you wished. There is a <a
Web framework</a> and the Recoll Python module, and can run href="https://bitbucket.org/medoc/recoll/src/5b4bd9ef26a1/src/python/samples/recollgui/qrecoll.py?at=default">bit
self-contained (no necessity to run apache or another web of sample code</a> in the source package doing just this. A few
server), so it's quite simple to set up. See: incompatible changes had to be made to the Python module. Especially the
See the <a href="https://github.com/koniu/recoll-webui/"> "Query.next" field is gone and the module structure has been changed
Recoll WebUI project</a> on GitHub. </li> (different import statement needed). Adapting your code is trivial, have a
look at the changes in the <a
<li>Thanks to Recoll user David, there is now a filter to href="https://bitbucket.org/medoc/recoll/src/5b4bd9ef26a10912bf8bd833fe6c084bd5a7bdbd/src/desktop/unity-lens-recoll/recollscope/rclsearch.py?at=default">Unity
index and retrieve <b>Lotus Notes</b> messages. See the Lens module</a> for an example. The new module is compatible with the <a
software href="http://www.python.org/dev/peps/pep-0249/">Python Database API
<a href="http://sourceforge.net/projects/rcollnotesfiltr/"> Specification v2.0</a> for the parts that make sense for a non-relational
site on sourceforge</a> and some DB.</li>
<a href="http://richardappleby.wordpress.com/2013/04/11/you-dont-have-to-know-the-answer-to-everything-just-how-to-find-it/"> <li>Recoll now uses a dynamic library for the code shared by the query
notes</a> from a user with a slightly different interface, the indexer and the Python module. This should have no visible
configuration.</li> 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>
<li>There is a new path translation facility, with a GUI </ul>
interface, to make it easier to share an index from a network </div>
share on clients on which the mount points might be </body>
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>
</html> </html>