Search/Filter using Lucene

Searching and filtering the ride list using a search box.
This is implemented using a new optional dependency on
CLucene.

Fixes #627.

INSTALL-LINUX

@@ -7,7 +7,7 @@
                                      John Ehrlinger
 
                                         May 2011
-                                      Version 1.0
+                                      Version 1.1
 
 A walkthrough of building GoldenCheetah from scratch on Ubuntu linux. This walkthrough
 should be largely the same for any Linux distro.
@@ -31,7 +31,8 @@ CONTENTS
      - flex
      - bison
    - libical - Diary window and CalDAV support (google/mobileme calendar integration)
-   - libvlc - Video playback in training mode
+   - libvlc  - Video playback in training mode
+   - clucene - Indexing/Searching ride files
 
 
 1. BASIC INSTALLATION WITH MANDATORY DEPENDENCIES
@@ -398,3 +399,29 @@ VLC_INSTALL = /usr/include/vlc/
 $ make clean
 $ qmake
 $ make
+
+CLUCENE - Indexing and Searching ride files (search box)
+--------------------------------------------------------
+
+You will need clucene runtime and core libraries, we developed against 0.9.21b-2 but
+any 0.9 branch should work fine, let us know if you experience any issues. You may find
+that the libclucene0ldbl runtime is already installed, this is fine and typical since
+clucene is a very popular search library.
+
+$ sudo apt-get install clucene-core
+$ sudo apt-get install libclucene0ldbl
+
+By default, and this is deliberate, the clucene install places the config headers into
+a platform specific location. For my install I just copy the platform (linux) specific
+header config into the normal /usr/include/CLucene directory with the following:
+
+$ sudo cp /usr/lib/CLucene/clucene-config.h /usr/include/CLucene
+
+Next we need to comment out the two CLUCENE lines in gcconfig.pri and they should read:
+
+CLUCENE_INCLUDE = /usr/include/CLucene
+CLUCENE_LIBS    = -lclucene
+
+$ make clean
+$ qmake
+$ make