From e22d1db445a52f3a9a5538ffa99e4f164fb2d49f Mon Sep 17 00:00:00 2001 From: Jean-Francois Dockes Date: Wed, 8 Sep 2010 08:36:00 +0200 Subject: [PATCH] add c++ compiler to build prerequisites --- src/doc/user/usermanual.sgml | 38 ++++++++++------- website/download.html | 79 +++++++++++++++++++----------------- 2 files changed, 66 insertions(+), 51 deletions(-) diff --git a/src/doc/user/usermanual.sgml b/src/doc/user/usermanual.sgml index 3fb0fa93..2eb75fd0 100644 --- a/src/doc/user/usermanual.sgml +++ b/src/doc/user/usermanual.sgml @@ -2711,17 +2711,27 @@ while query.next >= 0 and query.next < nres: Prerequisites - At the very least, you will need to download and install the - xapian core package - and the qt - run-time and development packages. - Check the + C++ compiler. Up to &RCL; version 1.13.04, its absence can + manifest itself by strange messages about a missing + iconv_open. + + Development files for + + Xapian core + + Development files for + + Qt . + + Development files for X11 and + zlib. + + Check the &RCL; download page for up to date version information. You will most probably be able to find a binary package for - qt for your system. You may have to + Qt for your system. You may have to compile &XAP; but this is not difficult (if you are using FreeBSD, there is a port). @@ -2736,7 +2746,7 @@ while query.next >= 0 and query.next < nres: Building - &RCL; has been built on Linux, FreeBSD, macosx, and Solaris, + &RCL; has been built on Linux, FreeBSD, Mac OS X, and Solaris, most versions after 2005 should be ok, maybe some older ones too (Solaris 8 is ok). If you build on another system, and need to modify things, @@ -3451,21 +3461,21 @@ skippedPaths = ~/somedir/∗.txt file. This would extract a specific mail header and use it as a searchable field, with data displayable inside result lists. (Side note: as the mail filter does no decoding on the values, - only plain ascii headers can be indexed, and that only the - first occurrence will be used in the case of multiple occurrence - headers). + only plain ascii headers can be indexed, and only the + first occurrence will be used for headers that occur several times). [prefixes] -# Index mail_mytag contents (with the given prefix) +# Index mailmytag contents (with the given prefix) mailmytag = XMTAG [stored] -# Store mail_mytag inside the document data record +# Store mailmytag inside the document data record (so that it can be +# displayed - as %(mailmytag) - in result lists). mailmytag = [mail] # Extract the X-My-Tag mail header, and use it internally with the -# mail_mytag field name +# mailmytag field name x-my-tag = mailmytag diff --git a/website/download.html b/website/download.html index 90ea2743..83c95bc1 100644 --- a/website/download.html +++ b/website/download.html @@ -118,52 +118,63 @@

Source

-

Current version: 1.13.04: +

Current version:1.13.04:

- - recoll-1.13.04.tar.gz. +

recoll-1.13.04.tar.gz. Recoll 1.13.04 fixes stemming, which was broken in 1.13. Changes. Bugs.

-

If you want to build Recoll from source, you will need to install - the Xapian core development libraries. You will find source and - binary packages on the - Xapian download page. - Recoll 1.13 needs at least xapian 1.0.5, I suggest using the - latest 1.0 Xapian (1.0.18 currently). It's at least quite - preferable to use a Xapian version after 1.0.12 as they don't - need the NEAR patch - any more.

+

Prerequisites for building from source:

+
    +
  • C++ compiler. Its absence sometimes manifests itself by + strange messages about iconv_open (fixed after 1.13.04).
    • -

    Compiling with Xapian - 1.2: because of some small - include file issues, Recoll 1.13 does not compile with Xapian - 1.2. You can apply this small - patch to fix the problem. With the patch applied, Recoll - works just fine with the latest and greatest Xapian.

    +

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

    You will also need the development files for libX11 and zlib.

    + Recoll 1.13 needs at least xapian 1.0.5, I suggest using the + latest 1.0 Xapian (1.0.18 currently). It's at least quite + preferable to use a Xapian version after 1.0.12 as they don't + need the NEAR patch + any more.

    - - - - -
    Qt: +

    Compiling with Xapian + 1.2: because of some small + include file issues, Recoll 1.13 does not compile with Xapian + 1.2. You can apply this small + patch to fix the problem. With the patch applied, Recoll + works just fine with the latest and greatest Xapian.

    + +
  • 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 also + 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), + 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. -

    + list.
    Qt 4.3, 4.4.x,4.5 and 4.6 seem to work fine.

    • +
-

Older recoll releases: - 1.13.02. +

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.

+ +

Older recoll releases:

+

+ 1.13.02. 1.12.4. 1.11.4. 1.10.6. @@ -179,12 +190,6 @@ 1.0.16.

-

A separate source file contains a KDE kicker applet to start - a Recoll search from the KDE toolbar: - 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.

Packages