[CLucene-dev] Linux port

[Jimmy P. <jp...@sd...>]

OK, The linux port is essentially done.  clucene is built both as a
shard object and a static library on Linux.  I am able to build an
index of a large archive of html files and search them with the demo
under examples. tests under examples builds as well but has some
runtime problems.  I will defer these until later as they are not
critical to getting started on Linux.  The problems don't look bad.
The port uses GNU autotools.  I have the following versions installed:

Autoconf 2.57
Automake 1.72
Libtool 1.5a

I am using GCC version 3.2.2.  This is important with repsect to the
autotools as well, because the gcc version affects the way autotools
calculates dependencies.  

If you use significantly older versions, I can almost guarantee
issues.  This is because each of the autotools is constantly changing
with little regard to backward compatability or even compatiability
with the other autotools.  I can try to assist you if you run into
problems.  

The linux source tree mirrors the Windows source tree purposely.
This was done so that eventually one download can build on both
OSes.  In fact, this is almost already a reality.  

The following will get you building assuming that you have suffciently
recent buld tools installed.  

1.) unpack tarball 
2.) cd clucene
3.) ./bootstrap

The following is what you should see...

++ libtoolize --force --copy --ltdl --automake
++ aclocal -I /usr/share/libtool/libltdl
++ autoconf
++ autoheader
++ automake -a --copy --foreign

If this happens breathe a sigh of relief.

4.) cd build
5.) ../configure CXXFLAGS="-g -DCOMPILER_GCC" CFLAGS="-g -DCOMPILER_GCC" --prefix=/home/your_name/clucene_test

6.) a lot of stuff will fly by the screen.  At the very end of the
output you should see:

config.status: creating Makefile
config.status: creating src/Makefile
config.status: creating src/CLucene/Makefile
config.status: creating src/CLucene/analysis/Makefile
config.status: creating src/CLucene/analysis/standard/Makefile
config.status: creating src/CLucene/document/Makefile
config.status: creating src/CLucene/index/Makefile
config.status: creating src/CLucene/queryParser/Makefile
config.status: creating src/CLucene/search/Makefile
config.status: creating src/CLucene/store/Makefile
config.status: creating src/CLucene/util/Makefile
config.status: creating examples/Makefile
config.status: creating examples/demo/Makefile
config.status: creating examples/tests/Makefile
config.status: creating examples/tests/test/Makefile
config.status: creating examples/tests/test/search/Makefile
config.status: creating examples/tests/test/queryParser/Makefile
config.status: creating config.h
config.status: executing depfiles commands

This is a very good sign.

7.) make install

7.1.) things will churn for a very long time, the clucene library will
be built as well as the examples.

8.) check /home/your_name/clucene_test/bin and /home/your_name/clucene_test/lib

In bin you should see:
demo test

In lib you should see:
libclucene.so.0.0.0 libclucene.la libclucene.a 
and symbolic links to these files.

9.) export LD_LIBRARY_PATH=/home/your_name/clucene_test/lib
10.) run the demo in bin directory
11.) create tests.store in bin directory, run the tests.  It will fail but
problems appear to be minor.  I will address these later.

If you made it to 11, then I am very pleased.  Most likely the build
scripts will need to be tweaked to run on your system, or you will
have to upgrade.  Shoot me an E-Mail if things turn out to be an
unmitigated disaster.

I will send via attachment the first Linux port to Doug Cutting and
Ben van Klinkehn. 

Cheers,
  Jimmy.