Some shell, awk, and perl scripts are not indexed. There is a
- simple
- configuration tweak workaround
-
The new mutagen-based audio tags filter (rclaudio) only
works with very recent mutagen
versions. See here for a
corrected version.
-
Performing a full index with release 1.11 or later, over a
+
Performing a full index with release 1.11 or newer, over a
version created with a much older recoll release may
sometimes end with an error saying "backend doesn't
implement metadata". If this happens, you need to delete
@@ -54,11 +49,7 @@
and restart indexing. For big indexes, to avoid losing
time, removing the directory preventively may be preferable .
-
If the user-chosen result list entry format results in
- several paragraphs (in the qt textedit sense), right clicks
- will only work inside the first one for each entry.
-
-
Under Solaris, it is necessary to perform initial
+
Under Solaris, it is necessary to perform the initial
indexing with the recollindex program (the recoll index
thread doesn't work for creating the database). Don't know
the reason. Only idea I have is problem with exception
@@ -84,6 +75,19 @@
slower indexing for all normal .doc files.
Some shell, awk, and perl scripts are not indexed. There is a
+ simple
+ configuration tweak workaround
+
The tree walk in indexing could loop on symbolic links.
+
If the user-chosen result list entry format results in
+ several paragraphs (in the qt textedit sense), right clicks
+ will only work inside the first one for each entry.
The indexing filters for some document types may need
+ external packages not installed on your system by default, and
+ not installed automatically with Recoll:
+
+ take a look at the list and decide what you need to
+ install.
+
+
The Recoll term explorer tool in phonetic mode (marginally
+ useful and optional) uses the aspell package, version
+ 0.60 (utf-8 support) or newer.
+
+
If you find problems with this page, the package or its
+ installation, please
+
+ report them.
+
+
What do the release numbers mean?
+
+
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.
+
+
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.
+
+
Z changes for bug fixes only,
+ and moving from X.Y.Z to X.Y.Z+u should in general involve
+ little risk of regression. But, any change can bring
+ problems, if you are not affected by the corrected bugs (check
+ the changes file), there is
+ probably no necessity to upgrade anyway.
C++ compiler. Its absence sometimes manifests itself by
+ strange messages about iconv_open (fixed after 1.13.04).
+
+
Xapian core development libraries. Most Linux distributions
+ carry them in their package repository. Or you will find source and
+ binary packages on the
+
+ Xapian download page. Recoll 1.14 needs at least
+ xapian 1.0.12. It is compatible with all later Xapian
+ releases, including the 1.2.x series.
Note on
+ building Xapian for older CPUs: 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.
+
+
+
X11 development files.
+
zlib development files.
+
Qt development files
+ You can build with Qt 3.3 or Qt 4. Recoll will
+ automatically be configured to build with Qt 4 if the version
+ of qmake found in $PATH:$QTDIR/bin is for Qt 4 (you can/should also
+ set the QMAKE variable to explicitely choose the
+ desired version, like QMAKE=qmake-qt4).
+
There seems to be a few issues in Qt 4.4.0 (2008-08-23),
+ resulting in problems when displaying the Recoll result
+ list. Qt 4.3, 4.4.x,4.5 and 4.6 seem to work fine.
+
+
+
KDE kicker applet:
+
the applet can start a Recoll search
+ from the KDE toolbar. It is in a separate source file.
+ recoll_applet-1.10.0.tgz.
+ This is a very slightly modified version of the
+
+ find_applet. It will work with any recoll version after 1.10.
+
+
Source repository:
+
The Recoll source repository is
+ hosted on
+ bitbucket.org.
+ The trunk is usually a bit on the bleeding edge, but there is
+ always a maintenance branch for the current production version.
Packages or ports for Recoll are available in the standard
+ repositories for many distributions.
+
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.
+
Most binary packages on this page need a Qt 4 runtime
+ environment (Qt 3.x is specified for a few). 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.
+
+
Ubuntu
+
+
There are Personal Package Archives on launchpad.net for
+
+ Xapian,
+
+ Recoll and kio-recoll. These were built from the latest versions,
+ for a set of Ubuntu series. You just need to add the
+ PPAs to your system software sources (the instructions are on
+ the PPA page or
+
+ here), and you can then use the normal package
+ manager to install or update Recoll and Xapian. To avoid
+ messages about signature errors, if not done at the previous step,
+ you may have to explicitely import the
+ Recoll and Xapian public keys:
Except if specified otherwise, the
+ executables inside the binary rpms which follow have a
+ static link to Xapian (1.0.16-21), there is no real dependency
+ except Qt 3 or Qt 4.
+ Some Fedora and Mandriva packages unfortunately think that they
+ depend on exiftool (which is needed by the little used jpeg
+ info filter), due to excessive rpmbuild cleverness.
+ You'll need to install the Xapian, Qt, and zlib development
+ packages if you want use the source rpms.
+
+
Fedora
+
Recoll is present in the standard Fedora package
+ repositories starting from F-12.
+
+
Fedora 6 with Qt 3.3.8 and a static link to xapian 1.0.21
+ built with --disable-sse
+ recoll-1.14.4-1.i586.rpm
+ Source:
+ recoll-1.14.4-1.src.rpm
+ This package usually also installs newer releases.
+
+
Fedora 12 and newer Recoll is now included in the
+ regular Fedora package repositories.
If you build from source on OpenSUSE 11, note that the default
+ qt4 version on some systems is 4.4.0 which will badly
+ display the the result list icons. Use qt3 or install a
+ newer version of qt4.
These are just prebuilt trees (without the source files).
+ Xapian is statically linked. They still depend on Qt. For
+ Solaris, you should be able to find a Qt package on
+ sunfreeware.
The FreeBSD ports track the Recoll releases quite
+ closely, so there is actually little point in using the
+ following (except that the port is currently (10-2010) broken).
Recoll also builds and runs on Solaris 10, but, given the
+ situation (2008) of open source packages for Solaris (very old
+ Qt on the Companion CD, inconsistent versions of the compiler and
+ non-threaded version of Qt on sunfreeware), I've come to the
+ temporary conclusion that you are better off building than
+ trying to install packages. The approach I tried in 2008 and
+ which worked was to:
+
+
Install gcc 3.4.6 and gnu make from the sunfreeware
+ packages (go to /usr/local). I guess that the gcc in
+ /usr/sfw should be ok too here.
+
Compile xapian-core and install it (with prefix /usr/local).
+
Configure and install Qt. The following config worked for me,
+ with Qt 3.3.8:
+
+ Then make. Weirdly, I had to add the Qt build lib/
+ directory to LD_LIBRARY_PATH at some point during the
+ build).
+
+
Set QTDIR=/usr/local/Trolltech/Qt-3.3.8 and
+ QMAKESPEC=/usr/local/Trolltech/Qt-3.3.8/mkspecs/solaris-g++
+ and add $QTDIR/bin to the PATH then configure, make and
+ install Recoll
+
Don't forget to use recollindex for the first index
+ build, recoll does not work for this (exception handling
+ mystery probably).
+
+
+
Obviously, there are other ways to do it (use CC, install
+ some place else ... ), but I tried this one.
There are ports for both xapian-core
+ and recoll in the standard tree, you may just need to update
+ your ports (cvsup, portsnap), or you can get the ports from
+ the FreeBSD site.
+
+ xapian port
+
+ recoll port.
Most of the translations for 1.13 are incomplete (and I
+ forgot to update the message files for 1.14, ugh). 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
+ me and
+ earn my gratefulness (and your less multilingual
+ compatriot's)...
+
+
You can use the .ts file to alter the translations if you
+ wish (use Qt's linguist tool to edit the source file,
+ then lrelease to produce the .qm file.).
+ The .qm file should be copied to
+ /usr/[local/]share/recoll/translations
+
+
+
recoll_xx.ts is a blank
+ Recoll 1.14 message file, handy to work on a new translation.
+
+
Updated 1.13/1.14 translations that became available after the
+ release:
The indexing filters for some document types may need
external packages not installed on your system by default, and
not installed automatically with Recoll:
@@ -70,8 +71,7 @@
0.60 (utf-8 support) or newer.
@@ -116,7 +116,7 @@
carry them in their package repository. Or you will find source and
binary packages on the
- Xapian download page. Recoll 1.14 needs at least
+ Xapian download page. Recoll 1.15 needs at least
xapian 1.0.12. It is compatible with all later Xapian
releases, including the 1.2.x series.
Note on
building Xapian for older CPUs: The
@@ -132,15 +132,8 @@
X11 development files.
zlib development files.
-
Qt development files
- You can build with Qt 3.3 or Qt 4. Recoll will
- automatically be configured to build with Qt 4 if the version
- of qmake found in $PATH:$QTDIR/bin is for Qt 4 (you can/should also
- set the QMAKE variable to explicitely choose the
- desired version, like QMAKE=qmake-qt4).
-
There seems to be a few issues in Qt 4.4.0 (2008-08-23),
- resulting in problems when displaying the Recoll result
- list. Qt 4.3, 4.4.x,4.5 and 4.6 seem to work fine.
+
Qt development files: Qt 4.4 or newer. The Recoll GUI
+ will not build with Qt releases older than 4.4.
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.
-
Most binary packages on this page need a Qt 4 runtime
- environment (Qt 3.x is specified for a few). 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.
+
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.
Except if specified otherwise, the
executables inside the binary rpms which follow have a
- static link to Xapian (1.0.16-21), there is no real dependency
- except Qt 3 or Qt 4.
+ static link to Xapian (1.0.16-21), there is no hard dependency
+ except Qt 4.
Some Fedora and Mandriva packages unfortunately think that they
depend on exiftool (which is needed by the little used jpeg
info filter), due to excessive rpmbuild cleverness.
@@ -235,66 +228,46 @@ sudo add-apt-repository ppa:recoll-backports/ppa
Recoll is present in the standard Fedora package
repositories starting from F-12.
-
Fedora 6 with Qt 3.3.8 and a static link to xapian 1.0.21
- built with --disable-sse
- recoll-1.14.4-1.i586.rpm
- Source:
- recoll-1.14.4-1.src.rpm
- This package usually also installs newer releases.
-
Fedora 12 and newer Recoll is now included in the
regular Fedora package repositories.
If you build from source on OpenSUSE 11, note that the default
- qt4 version on some systems is 4.4.0 which will badly
- display the the result list icons. Use qt3 or install a
- newer version of qt4.
Recoll also builds and runs on Solaris 10, but, given the
- situation (2008) of open source packages for Solaris (very old
- Qt on the Companion CD, inconsistent versions of the compiler and
- non-threaded version of Qt on sunfreeware), I've come to the
- temporary conclusion that you are better off building than
- trying to install packages. The approach I tried in 2008 and
- which worked was to:
-
-
Install gcc 3.4.6 and gnu make from the sunfreeware
- packages (go to /usr/local). I guess that the gcc in
- /usr/sfw should be ok too here.
-
Compile xapian-core and install it (with prefix /usr/local).
-
Configure and install Qt. The following config worked for me,
- with Qt 3.3.8:
-
- Then make. Weirdly, I had to add the Qt build lib/
- directory to LD_LIBRARY_PATH at some point during the
- build).
-
-
Set QTDIR=/usr/local/Trolltech/Qt-3.3.8 and
- QMAKESPEC=/usr/local/Trolltech/Qt-3.3.8/mkspecs/solaris-g++
- and add $QTDIR/bin to the PATH then configure, make and
- install Recoll
-
Don't forget to use recollindex for the first index
- build, recoll does not work for this (exception handling
- mystery probably).
-
-
-
Obviously, there are other ways to do it (use CC, install
- some place else ... ), but I tried this one.
+
I did not test building on Solaris for this version. You will
+ need at least Qt 4.4. The old hints
+ in the previous page may
+ still be valid.
Most of the translations for 1.13 are incomplete (and I
- forgot to update the message files for 1.14, ugh). 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
- me and
- earn my gratefulness (and your less multilingual
+
Most of the translations for 1.15 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 me and earn
+ my gratefulness (and your less multilingual
compatriot's)...
You can use the .ts file to alter the translations if you
@@ -395,17 +331,17 @@ sudo add-apt-repository ppa:recoll-backports/ppa
recoll_xx.ts is a blank
- Recoll 1.14 message file, handy to work on a new translation.
+ Recoll 1.15 message file, handy to work on a new translation.
-
Updated 1.13/1.14 translations that became available after the
+
Updated 1.15 translations that became available after the
release: