This commit is contained in:
Jean-Francois Dockes
2016-06-15 11:59:58 +02:00
parent 1b447ab610
commit 841913f154
7 changed files with 166 additions and 211 deletions
+84 -82
View File
@@ -69,7 +69,7 @@
<div id="general">
<h2><a name="general">General information</a></h2>
<p>The current version is 1.21.7. <a href="release-1.21.html">Release
<p>The current version is 1.22.1. <a href="release-1.22.html">Release
notes</a>.</p>
<p>Recoll <a href="usermanual/usermanual.html#RCL.INSTALL">Installation / building
@@ -116,20 +116,20 @@
<div id="source">
<h2><a name="source">Source</a></h2>
<h3>Current release distribution: 1.21.7:</h3>
<h3>Current release distribution: 1.22.1:</h3>
<!-- Attention: source packages must remain here, not in a
subdirectory, because of all the places they're referred from
(package watches) -->
<p><a href="recoll-1.21.7.tar.gz">recoll-1.21.7.tar.gz</a>.</p>
<h3>1.22.0:</h3>
<p>As with any .0 release, don't use this is you absolutely
don't want to run into trouble:</p>
<p><a href="recoll-1.22.0.tar.gz">recoll-1.22.0.tar.gz</a>.</p>
<p><a href="recoll-1.22.1.tar.gz">recoll-1.22.1.tar.gz</a>.</p>
<p><a href="release-1.22.html">The release notes</a>.</p>
<h3>Previous production release 1.21.7:</h3>
<p><a href="recoll-1.21.7.tar.gz">recoll-1.21.7.tar.gz</a>.</p>
<p><a href="release-1.21.html">The release notes</a>.</p>
<!--
<h3>Snapshot</h3>
<p>I sometimes release a source tarfile when I consider that the
@@ -145,69 +145,76 @@
<p>You will probably get these from the <a href="#ubuntu">PPA</a>, but
here are the source files. These are not included in the main tar file
any more. For recoll 1.19, 1.20 and 1.21 installations (choose on the
any more. For any Recoll version after 1.19 (choose on the
Ubuntu version, not the Recoll one):
<blockquote>
<a href="recoll-lens-1.19.10.3543.tar.gz">
recoll-lens-1.19.10.3543.tar.gz</a> (Recoll 0.19 or 0.20,
Ubuntu up to 13.04 Raring)<br>
recoll-lens-1.19.10.3543.tar.gz</a> (Ubuntu up to 13.04
Raring)<br>
<a href="unity-scope-recoll-1.20.2.4.tar.gz">
unity-scope-recoll-1.20.2.4.tar.gz</a> (Recoll 0.19 and later, Ubuntu
13.10 and later).<br>
unity-scope-recoll-1.20.2.4.tar.gz</a> (Ubuntu 13.10 and
later).<br>
</blockquote>
For Recoll 1.18:
<a href="recoll-lens-1.18.1.2997.tar.gz">recoll-lens-1.18.1.2997.tar.gz</a><br>
<a href="recoll-lens-1.18.1.2997.tar.gz">
recoll-lens-1.18.1.2997.tar.gz</a><br>
For Recoll 1.17:
<a href="recoll-lens-1.17.2.2697.tar.gz">recoll-lens-1.17.2.2697.tar.gz</a>
<a href="recoll-lens-1.17.2.2697.tar.gz">
recoll-lens-1.17.2.2697.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>
<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>.
<li>C++ compiler. Be aware that its absence sometimes
manifests itself by quite cryptic messages.</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>
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>Qt development files: Qt 4.4, 5.3 or newer (5.2 not ok).</li>
<li>Qt WebKit development files: these are quite often
distributed apart from the main Qt libraries. It is
possible to configure Recoll not to use Qt WebKit (see
configure --help).</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>
<li>X11 development files.</li>
<li>Python development package: you can avoid needing this
by configuring with --disable-python-module.</li>
</ul>
<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 <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>
<h3>Instructions for building</h3>
<p>Normally, it's just <tt>./configure; make; make install</tt>. If a bit
more detail is needed,
<p>Normally, it's just:</p>
<div class="code">./configure; make; make install</div>
<p>If a bit more detail is needed,
<a href="http://www.recoll.org/usermanual/usermanual.html#RCL.INSTALL.BUILDING">
there is some in the manual</a>.
@@ -216,76 +223,71 @@
<div id="packages">
<h2><a name="packages">Packages</a></h2>
<p>Packages or ports for Recoll are available in the standard repositories for
many distributions.</p>
<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 some pointers to find newer packages for some
distributions. In most cases, you will just need to use an
alternate repository.</p>
<p>I sometimes build binary packages when no appropriate repository
exists. Any binary package directly linked from 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>
<p>However they are often a bit older or built with older
Xapian releases. Here follow some pointers to find newer
packages for some distributions. In most cases, you will
just need to use an alternate repository.</p>
<h3><a name="debian">Debian</a></h3>
<p>The Debian Recoll packages are usually fairly up to date, just use
the appropriate Debian repository.</p>
<p><i>Except they're not at the moment (2015-10)...</i>. So
<p><i>Except they're not at the moment (2016-10)...</i>. So
I am maintaining a repository for packages built for Debian Wheezy,
and Jessie. This currently has recoll 1.21.x (the
standard repos have 1.17...) To add the repository to your
sources:</p>
<p>The public part of the key used to sign the repositories can
be downloaded and installed as follows:</p>
<div class="code">
wget -O - http://www.lesbonscomptes.com/key/jf@dockes.org.gpg.key | sudo apt-key add -
</div>
<ul>
<li>Download the public key used to validate the repositories:
<div class="code">
wget -O - http://www.lesbonscomptes.com/key/jf@dockes.org.gpg.key | sudo apt-key add -
</div>
</li>
<li>Create and edit <span class="filename">
/etc/apt/sources.list.d/recoll.list</span>
and add the following lines:<br>
for wheezy (debian 7.x):<br>
<div class="code">
deb http://www.lesbonscomptes.com/recoll/debian/ wheezy main
deb-src http://www.lesbonscomptes.com/recoll/debian/ wheezy main
deb http://www.lesbonscomptes.com/recoll/debian/ wheezy main
deb-src http://www.lesbonscomptes.com/recoll/debian/ wheezy main
</div>
for jessie (debian 8.x):<br>
<div class="code">
deb http://www.lesbonscomptes.com/recoll/debian/ jessie main
deb-src http://www.lesbonscomptes.com/recoll/debian/ jessie main
deb http://www.lesbonscomptes.com/recoll/debian/ jessie main
deb-src http://www.lesbonscomptes.com/recoll/debian/ jessie main
</div>
<li>Then:
<div class="code">
sudo apt-get update
sudo apt-get install recoll [python-recoll python3-recoll]
sudo apt-get update
sudo apt-get install recoll python-recoll python3-recoll
</div>
</li>
</ul>
<p>If you prefer to manually install the packages, they are here:
<a href="debian/pool/main/r/recoll/">debian/pool/main/r/recoll/</a><br/>
<a href="debian/pool/main/r/recoll/">
debian/pool/main/r/recoll/</a><br/>
</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: </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>
<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 the current set of supported Ubuntu
versions. Procedure:</p>
<div class="code">
sudo add-apt-repository ppa:recoll-backports/recoll-1.15-on
sudo apt-get update
sudo apt-get install recoll
</div>
<p>The packages in the PPA now have a separate package for the Python
extension, like the standard ones, so there should be no more