From e4da5e810c8a197d4727bc23400a80ca810bf056 Mon Sep 17 00:00:00 2001 From: dockes Date: Wed, 21 Oct 2009 07:15:19 +0000 Subject: [PATCH] 1.12.2 release --- website/BUGS.html | 543 ++++++++++---------- website/CHANGES.html | 884 +++++++++++++++++---------------- website/devel.html | 98 +++- website/download.html | 235 +++++---- website/features.html | 2 +- website/index.html.en | 13 +- website/index.html.fr | 10 +- website/pics/index.html | 39 +- website/{ => pics}/mario.png | Bin website/pics/recoll5-thumb.png | Bin 40746 -> 53001 bytes website/pics/recoll5.png | Bin 28877 -> 237133 bytes website/{ => pics}/smile.png | Bin 12 files changed, 1027 insertions(+), 797 deletions(-) rename website/{ => pics}/mario.png (100%) rename website/{ => pics}/smile.png (100%) diff --git a/website/BUGS.html b/website/BUGS.html index 94178487..e874d892 100644 --- a/website/BUGS.html +++ b/website/BUGS.html @@ -21,9 +21,9 @@
@@ -32,358 +32,383 @@

Known bugs in current and older versions

Bugs that are listed in an older version section are - supposedly fixed in later versions. Bugs listed in the - topmost section may also exist in older versions.

+ supposedly fixed in later versions. Bugs listed in the + topmost section may also exist in older versions.

-

Latest (recoll 1.12.0 + xapian 1.0.10)

+

Latest (recoll 1.12.1 + xapian 1.0.15)

1.11.4

1.11.1

1.10.6

1.10.1

1.10.0

1.9.x

1.8.2

1.8.1

1.7.5

1.7.3

1.6.2

1.5.10

1.5.[1-7]

1.5.0

1.3.3

1.2.2

diff --git a/website/CHANGES.html b/website/CHANGES.html index 2bd5e957..e188e2a9 100644 --- a/website/CHANGES.html +++ b/website/CHANGES.html @@ -1,4 +1,4 @@ - + Recoll changes @@ -21,645 +21,687 @@

Recoll journal of user-visible changes

+ +

1.12.2

+

This is a bug fix release.

+ + + +

1.12.1

+

This is a very minor release, mainly to fix compilation + issues and a few very minor bugs. No need to upgrade if + you don't experience these.

+ +

1.12.0

1.11.4

1.11.0

Recoll release 1.11 has relatively extensive changes that have - necessitated a modification of the index format. Hence installing this - release implies a full re-indexing, which is enforced by the - software.

+ necessitated a modification of the index format. Hence installing this + release implies a full re-indexing, which is enforced by the + software.

1.10.6

1.10.5

1.10.2

1.10.1

1.10.0

1.9.0

1.8.2 2007-05-19

1.8.1 2007-02-20

1.7.6 2007-01-30

1.7.5 2007-01-15

1.7.3 2007-01-09

1.6.3

1.6.2

1.6.1

1.5.9

1.5.8

1.5.6

1.5.1

1.5.0 2006-09-20

1.4.3 2006-05-07

1.3.3 2006-04-04

1.2.3 2006-03-03

1.2.2 2006-02-02

1.2.0 2006-02-01

1.1.0 2006-01-12

1.0.16 2006-01-05

1.0.15

1.0.14

1.0.13

1.0.12

1.0.11

1.0.10

1.0.9

1.0.8

diff --git a/website/devel.html b/website/devel.html index 416735ba..470e47f8 100644 --- a/website/devel.html +++ b/website/devel.html @@ -34,7 +34,7 @@ please send me an email.

-

Translation

+

Translation

More translations is good ! If you are a non-english speaker (and understand english, which can probably be assumed, you @@ -55,7 +55,7 @@

  • Ukrainian: recoll_uk.ts
    • -

    Development

    +

    Development

    Apart from general development for additional functionality or bug fixes, the following tasks are waiting for you:

    @@ -79,6 +79,100 @@
  • Etc. :)
    • +

    Problem reporting

    + +

    Once in a while it will happen that a Recoll program will + crash (either the "recoll" graphical interface or the + "recollindex" command line indexing command).

    + +

    Reporting crashes is very useful. It can help others, and it + can get your own problem to be solved.

    + +

    All reports are useful. But, in order to maximize usefulness, + a crash report should include a so-called stack trace, something + that indicates what the program was doing when it + crashed. Getting a useful stack trace is not very difficult, + but it may need a little work on your part (which + will then enable me do my part of the work).

    + +

    If your distribution includes a separate package for Recoll + debugging symbols, it probably also has a page on its web site + explaining how to use them to get a stack trace. You should + follow these instructions. If there is no debugging package, + you should follow the instructions below. A little + familiarity with the command line will be necessary.

    + +
    Compiling and installing a debugging version
    +
    +
      +
    • Obtain the recoll source for the version you are using + (www.recoll.org), + and extract the source tree.
      • + +
    • Follow the instructions for + + building Recoll from source with the following + modifications: +
        +
      • Before running configure, edit + the mk/localdefs.in file and remove the -O2 + option(s).
        • +
      • When running configure, specify the + standard installation location for your system as a prefix + (to avoid ending up with two installed versions, which + would almost certainly end in confusion). On Linux this + would typically be: +
        configure --prefix=/usr. +
      • When installing, arrange for the installed + executables not to be stripped of debugging symbols by + specifying a value for the STRIP environment variable + (ie: echo or ls):
        sudo make + install STRIP=ls +
        • +
      +
    + +
    Getting a core dump
    +
    You will need to run the operation that caused the crash + inside a writable directory, and tell the system that you + accept core dumps. The commands need to be run in a shell + inside a terminal window. Ie: + 
    
+cd
+ulimit -c unlimited
+recoll  #(or recollindex or whatever you want to run).
+
    + + Hopefully, you will succeed in getting the command to crash, + and you will get a core file. +
    + +
    Using gdb to get a stack trace
    +
    +
      +
    • Install gdb if it is not already on the system.
      • + +
    • Run gdb on the command that crashed and the + core file (depending on the system, the core file may be + named "core" or something else, like recollindex.core, or + core.pid), ie: + +
      gdb /usr/bin/recollindex core +
      • +
    • Inside gdb, you need to use different + commands to get a stack trace for recoll + and recollindex. For recollindex you + can use the bt command. For recoll + use:
      thread apply all bt full +
      • +
    • Copy/paste the output to your report email :), and + quit gdb ("q").
      • +
    +
    +
    + diff --git a/website/download.html b/website/download.html index 2c245b3e..900cf630 100644 --- a/website/download.html +++ b/website/download.html @@ -117,16 +117,19 @@

    Source

    -

    Current version:1.12.0: - recoll-1.12.0.tar.gz. +

    Current version: 1.12.2: + recoll-1.12.2.tar.gz. Changes. Bugs. +

    -

    In order to build Recoll from source, you will need a - xapian-core installation. You will find source and binary +

    In order 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.12 needs at least xapian 1.0.5, and I can see no - reason not to use the latest 1.0 Xapian (1.0.10 currently).

    + Recoll 1.12 needs at least xapian 1.0.5, I suggest + using the latest 1.0 Xapian (1.0.16 currently). Xapian + versions after 1.0.12 don't need the + NEAR patch any more.

    Qt: @@ -143,101 +146,116 @@

    Older recoll releases: - 1.11.4. - 1.10.6. - 1.9.0. - 1.8.2. - 1.7.6. - 1.6.3. - 1.5.11. - 1.4.3. - 1.3.3. - 1.2.3. - 1.1.0. - 1.0.16. + 1.12.1. + 1.11.4. + 1.10.6. + 1.9.0. + 1.8.2. + 1.7.6. + 1.6.3. + 1.5.11. + 1.4.3. + 1.3.3. + 1.2.3. + 1.1.0. + 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. + 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.

    + find_applet. It will work with any recoll version after 1.10.

    Packages

    -

    The executables inside the binary rpms have a static link to - xapian 1.0.10, there is no real dependency except Qt 3.3 - (or Qt 4.1 when mentioned). - 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. -
    - Of course you need xapian-core installed to use the source - rpms.

    +

    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.

    -

    Fedora Core 6-9 with Qt 3.x - - recoll-1.12.0-1.i386.rpm. +

    Ubuntu

    +
    +

    + Xapian and + + Recoll have Personal Package Archives on + launchpad.net. These hold the latest versions, compiled for a + set of Ubuntu series. + You just need to add the PPAs to your system software sources, + and you can then install the normal package manager to install + or update Recoll and Xapian. + To avoid messages about signature errors, you will have to + import the Recoll and Xapian public keys: + 

    
+gpg --keyserver keyserver.ubuntu.com --recv 9DA85604
+gpg --export --armor 9DA85604 | sudo apt-key add -
+gpg --keyserver keyserver.ubuntu.com --recv A0735AD0
+gpg --export --armor  A0735AD0 | sudo apt-key add -
+
    +

    +
    + +

    RPMS

    +

    The executables inside the binary rpms which follow have a + static link to Xapian 1.0.16, 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 need to install the Xapian library development + package if you want use the source rpms.

    + +

    Fedora

    +
    +

    Fedora Core 6 with Qt 3.3.8 + + recoll-1.12.2-1.i386.rpm. Source: - - recoll-1.12.0-1.src.rpm - This package also installs and runs on Fedora 9. + + recoll-1.12.2-1.src.rpm + This package usually also installs and runs on Fedora 9.

    Fedora Core 10 with Qt 4 - - recoll-1.12.0-1.fc10.i586.rpm. + + recoll-1.12.2-1.fc10.i586.rpm. Source: - - recoll-1.12.0-1.fc10.src.rpm + + recoll-1.12.2-1.fc10.src.rpm

    +
    -

    Mandriva 2006 with Qt 3 (also works on 2005 and 2007). - - recoll-1.12.0-0.1.20060mdk.i586.rpm. +

    OpenSUSE

    +
    +

    OpenSUSE 11.0 with qt3: + + recoll-1.12.2-0.i586.rpm. + Source: + recoll-1.12.2-0.src.rpm

    +

    OpenSUSE 11.1 with qt4: + + recoll-1.12.2-0.i586.rpm. + Source: + recoll-1.12.2-0.src.rpm

    +

    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.

    +
    + +

    Mandriva

    +
    + +

    Mandriva 2008 with Qt 4: + + recoll-1.12.2-1mdv2008.1.i586.rpm. Source: - - recoll-1.12.0-0.1.20060mdk.src.rpm -

    -

    Mandriva 2008 with Qt 4 - - recoll-1.12.0-1mdv2008.1.i586.rpm. - Source: - - recoll-1.12.0-1mdv2008.1.src.rpm -

    - -

    Suse 11.0 with qt3 - - recoll-1.12.0-0.i586.rpm. - Source: - - recoll-1.12.0-0.src.rpm
    - If you build from source on OpenSuse 11, note that the default - qt4 version is 4.4.0 which will badly display the result list - icons. Use qt3 or install a newer version of qt4. -

    - -

    Ubuntu 6.06 dapper / edgy / gutsy / hardy - - recoll_1.12.0-0ubuntu1_i386.deb - debian/dapper. This package was - built on "dapper" and appears to work correctly on later - Ubuntu releases. This package is not configured for real-time - indexing.

    -

    Here is a package for Ubuntu 8.04 Hardy which supports - real-time indexing. It is also built for qt4, so this must be - installed on the target system. Avoid qt 4.4.0 (from hardy - backports). The standard 4.3.x is fine (or 4.4.1 and later) - - debian/hardy/recoll_1.12.0-0ubuntu1_i386.deb -

    - -

    Debian unstable Recoll is in the package repository, - you can install it with the usual apt-get install recoll. - - Package page

    + + recoll-1.12.2-1mdv2008.1.src.rpm +

    +

    Binary bundles

    @@ -245,27 +263,39 @@ The executables were built with xapian 1.0.8 (patched for the NEAR bug) and libiconv 1.9.2 (where relevant) as static libraries. They depend on Qt 3.3. For Solaris, you should be - able to find a Qt package - here.

    + able to find a Qt package on + sunfreeware.

    -

    The installation instructions are there.

    +

    Installation + instructions here.

    -

    FreeBSD 6.4 i386: - - recoll-1.12.0-FreeBSD-6.4-STABLE.tgz -

    +

    FreeBSD

    +
    +

    The FreeBSD ports track the Recoll releases quite + closely, so there is actually little point in using the + following. Only for the really impatient:

    +

    FreeBSD 6.4 i386 Qt 4.4.3: + + recoll-1.12.2-FreeBSD-6.4-STABLE.tgz +

    +

    FreeBSD 7.2 i386 Qt 4.5.2: + + recoll-1.12.2-FreeBSD-7.2-STABLE.tgz +

    +
    -

    Solaris 8 sparc. - Note to Solaris users: you need to perform the initial - indexing pass with "recollindex", not the recoll GUI indexing - thread. See errata. - - recoll-1.12.0-SunOS-5.8.tgz. +

    Solaris

    +
    +

    Note to Solaris users: you need to perform the initial + indexing pass with "recollindex", not the recoll GUI indexing + thread. See errata. +

    Solaris 8 SPARC: + + recoll-1.12.2-SunOS-5.8.tgz.

    Recoll also builds and runs on Solaris 10, but, given the - situation of open source packages for Solaris (very old Qt on - the Companion CD, inconsistent versions of the compiler and + 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 @@ -277,9 +307,9 @@

  • 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: -
    +
    
 ./configure -platform solaris-g++ -prefix /usr/local/Trolltech/Qt-3.3.8/ -thread
-
    
+
    Then make. Weirdly, I had to add the Qt build lib/ directory to LD_LIBRARY_PATH at some point during the build). @@ -295,6 +325,7 @@

    Obviously, there are other ways to do it (use CC, install some place else ... ), but I tried this one.

    +

    • FreeBSD ports

    diff --git a/website/features.html b/website/features.html index 6b80ba0b..10790d5b 100644 --- a/website/features.html +++ b/website/features.html @@ -38,7 +38,7 @@
    Supported systems
    Recoll has been compiled and tested on FreeBSD, Linux, Darwin and Solaris (versions - FreeBSD 5/6, Redhat 7/8/9, Fedora Core 5/6/7, Suse 10/11, + FreeBSD 5-7, Redhat 7/8/9, Fedora Core 5-10, Suse 10/11, Gentoo, Debian 3.1, Solaris 8/9/10. Other not too distant releases should be ok too).
    diff --git a/website/index.html.en b/website/index.html.en index 6aa29ca5..b0403b00 100644 --- a/website/index.html.en +++ b/website/index.html.en @@ -47,7 +47,7 @@

    Recoll is free, open source, and licensed under the GPL. The current version is - 1.12.0 + 1.12.2 (Changes).

    Features:

    @@ -55,7 +55,7 @@