From b7fcf79db86257a3697117c02c9060046ccb04d0 Mon Sep 17 00:00:00 2001 From: Jean-Francois Dockes Date: Fri, 19 Dec 2014 09:53:21 +0100 Subject: [PATCH] doc --- website/download-1.19.html | 422 +++++++++++++++++++++++++++++++++++++ 1 file changed, 422 insertions(+) create mode 100644 website/download-1.19.html diff --git a/website/download-1.19.html b/website/download-1.19.html new file mode 100644 index 00000000..6062b6e3 --- /dev/null +++ b/website/download-1.19.html @@ -0,0 +1,422 @@ + + + + Recoll download + + + + + + + + + + + + + + +
+ +
+ +
+

Recoll downloads

+ +
+ + + + + + + + + + + + + +
+ General + Source + Packages (.rpm and .deb) + Known bugs + Mac ports + Updated Filters + Translations
+
+ +
+

General information

+ +

The current version is 1.19.14p2. Release +notes.

+ +

The download page for Recoll 1.18 is still +available.

+ +

Recoll Installation / building +manual.

+ +

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: 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 release file), there +is probably no necessity to upgrade anyway.

+
+ +
+

Known bugs

+

There is a history of known bugs, sorted + by fix release. Also see + the + issue tracker on Bitbucket. +

+
+ +
+

Source

+ +

Current release distribution: 1.19.14p2:

+ + +

recoll-1.19.14p2.tar.gz.

+ +

1.20 preview

+ +

Recoll 1.20 will contain no revolutionary changes, but a set of +hopefully useful adjustments, which will be released in a series of +incremental snapshots. The current snapshot is + +recoll-1.20.0p2.tar.gz. + +See the release notes for what's in +there.

+ + + +

Ubuntu Unity Lens and Scope

+

This are not included in the main tar file any more.

+For 1.19 and 1.20 installations: + + recoll-lens-1.19.10.3543.tar.gz (up to Ubuntu 13.04 Raring)
+ + unity-scope-recoll-1.19.12.tar.gz (Ubuntu 13.10 and later).
+For 1.18: + + recoll-lens-1.18.1.2997.tar.gz
+For 1.17: + + recoll-lens-1.17.2.2697.tar.gz

+ +

Prerequisites for building from source:

+
    +
  • 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 should still work with Xapian 1.0, but it is highly recommended to + use a Xapian 1.2 version.

    +

    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: Qt 4.4 or newer. The Recoll GUI will not build + with Qt releases older than 4.4.

    +
    • +

  • 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).

    +
    • +
  • Python development package: you can avoid needing this by configuring + with --disable-python-module.
    • +
+ +

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.

+ +

Instructions for building

+ +

Normally, it's just configure; make; make install. If a bit + more detail is needed, + + there is some in the manual. + +

Older recoll releases:

+ +

A whole bunch is + there, but I can see + no reason whatsoever to use one of these versions.

+ +
+ +
+

Packages

+ +

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 some pointers to find newer packages for some + distributions. In most cases, you will just need to use an + alternate repository.

+ +

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.

+ +

Debian

+ +

The Debian Recoll packages are usually fairly up to date (at least in +testing), just use the appropriate Debian repository.

+ +

Except they're not at the moment (2014-05).... So here are +1.19.14p2 packages for Debian stable (Wheezy):
+python3-recoll_1.19.14p2-1_amd64.deb
+python3-recoll_1.19.14p2-1_i386.deb
+python-recoll_1.19.14p2-1_amd64.deb
+python-recoll_1.19.14p2-1_i386.deb
+recoll_1.19.14p2-1_amd64.deb
+recoll_1.19.14p2-1_i386.deb
+

+ +

You can list the directory for the +source package and other files).

+ +

Ubuntu

+ +

There are Personal Package Archives on launchpad.net for Recoll, +kio-recoll and recoll-lens. These were built from the latest versions, for +a set of Ubuntu series. starting at Lucid. The installation is very simple:

+

+          sudo add-apt-repository ppa:recoll-backports/recoll-1.15-on
+          sudo apt-get update
+          sudo apt-get install recoll
+
+ +

The 1.19 packages in the PPA now have a separate package + for the Python extension, like the standard ones, so there should be + no more conflict issues while switching from the PPA to the normal + repositories and back.

+ +
+

Notes for Ubuntu Lucid

+
    +
  • If you still use Ubuntu 10.04 (Lucid), you will need + to add the Xapian + backports PPA to provide the libxapian22 package
    • +
  • The rclepub filter apparently needs Python + 2.7. You will need to install it and modify the first line of the + filter script to execute python2.7 instead of + python.
    • +
+
+ +

Linux Mint

+ +

The Ubuntu PPA works perfectly for Mint 13 (and probably other releases +too). Just follow the instructions for Ubuntu.

+ +

RPMS

+ +

You'll need to install the Xapian, Qt, Qt-Webkit 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. The new versions are usually tracked quite closely, but + 1.19.14p2 is not there yet, so here are some packages + for Fedora 20 and Fedora + 21. There are only x86_64 binaries for now, use the source rpm + for other archs.

+ +

OpenSUSE

+ +

Recoll is in the KDE:Extra repository. You just need to add the + repository to your software + sources (Yast2->software->Software repositories).
+ + Repository list (supported Suse versions). + 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.

+ + + +
+ +
+

Ports

+ +

Mac port

+ +

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).

+ +

Recoll is in MacPorts and really easy to install:

+
    +
  1. Install + MacPorts.
    2. +
  2. Type "sudo port install recoll"
    3. +
+ +

Recoll is then available from the command line and as an icon in the usual +MacPorts applications place.

+
+ +
+

Updated filters

+

new or updated filters + sometimes become available after a release. As a rule, all + filters are compatible with all Recoll versions. Any + compatibility problem will be explicitely mentionned.

+
+ +
+

Translations

+ +

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 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 .qmfile should be +copied to /usr/[local/]share/recoll/translations +

+ +

recoll_xx.ts is a blank Recoll 1.19 +message file, handy to work on a new translation.

+ +

Updated 1.19 translations that became available after the release:

+ +

A Simplified Chinese translation by 蔡火胜: +recoll_zh_CN.ts +recoll_zh_CN.qm +

+ +

A Polish translation by Tymoteusz: +recoll_pl.ts +recoll_pl.qm +

+ +

All the following translations are up to date in release + 1.19.12. For older ones:

+

Greek translation, thanks to Dimitrios +recoll_el.ts +recoll_el.qm +

+ +

German translation, thanks to Jonatan +recoll_de.ts +recoll_de.qm +

+ + + +

Note that, if you are running an older release, you may find updated +messages by looking inside the appropriate maintenance branch on bitbucket.

+ +
+ +
+ + +