This document describes how to compile the lq-text text retrieval database package, and how to install it on your system.
You must be using the Unix operating system to do this installation. Most versions of Unix will do, inclusing SunOS, Solaris 2, HP/UX and Linux, for example.
If you are not experienced at porting C programs, you should not try to install lq-text on Digital Unix (OSF/1) or other 64-bit systems.
In order to complete the installation, you'll need:
Once you are ready to start, and have all the pieces ready, the entire process should take between fifteen minutes and an hour.
If you have decided to use db, you should configure and install it now. See the instructions included with that package.
If instead you decided to use sdbm or ndbm, you can proceed directly to the next step.
gunzip < lq-text1.14.tgz | tar xvf -
First, go into the source directory:
cd lq-text1.14/src
Now, you have three files to edit:
At this point you should be able to type
make
to the Unix shell and go away for a few minutes. If everything goes OK, you should see a message saying that the package has been compiled succesfully. If you get an error message and Make says Stop or Error instead, see the Troubleshooting Guide.
Now you are ready to test and then install lq-text.
A simple test suite is inlcuded, and you can run it like this:
make test
This may take a few minutes.
If there are no problems, you will see a message saying that the tests succeeded. If there were problems, see the Troubleshooting Guide.
You should first try a dry run, to make sure that the package is going to go where you expect:
make -n install
If this looks like it is going to do what you expect, you can install the pckage with
make install
This will copy files to the correct locations.
You have now installed lq-text, and you are ready to start using it. You can try out a short tutorial, or go straight to the meat of the Reference Manual.