ht://Dig © 1995-1998 Andrew Scherpbier
Please see the file COPYING for
license information.
This document will attempt to show the steps needed to build
and install the ht://Dig system.
The main sections are:
% tar xzf tarfile.tar.gzIf you do not have GNU tar, you can do the following:
% gunzip -c tarfile.tar.gz | tar xf -In either case, a new directory will be created under which the distribution will be extracted. The directory it creates will be htdig- followed by the version number.
Once the distribution has been extracted, change to the newly
created directory.
In this directory you will need execute the configure program:
% ./configureThis program will attempt to determine what your particular system can and can't do.
The configure program may produce some warnings about libguile and guile. Ignore those warnings since they do not affect the ht://Dig program at all.
After this, you will need to edit the file CONFIG. There are several values which you need to change in this file. Note that more recent versions of ht://Dig (after 3.1.0b2) will allow you to use./configure --prefix=and
--exec-prefix=to set the DEST and BIN_DIR variables automatically.
The configure program will have created Makefiles in all the important directories. It is important to note that the Makefiles created assume that you use a make program that knows how to deal with
include filenameSome make programs do not allow this or have a different syntax for including. In this case, you should probably obtain GNU make.
At this point you can optionally add dependency information to all the make files with the command
% make dependthis only needs to be done if you are going to change any of the sources to ht://Dig.
Now build the complete system with
% make(Sit back and relax for a while...)
If the compilation failed with the error that it cannot find libht.a, the most likely problem is that your system does not have libg++ installed. Please check the system requirements for details on this.
Everything should have built at this point. To install the software, you need to execute
% make installThis will perform several tasks. It will first attempt to create the directories that you specified in the CONFIG file. It will then copy the following programs to the BIN_DIR directory you specified in the CONFIG file: It will also copy the htsearch program to your CGIBIN_DIR directory.
After this, several files will be customized and installed. Here is a list of the files that get installed:
Note that these files will never replace any existing files that may already be installed.It is also important to note that these files are mostly examples. As they stand, they will work, but you probably want to modify them to reflect your needs.
After the installation, your will be ready to test out everything. You can use the rundig script to make a test database of the online documentation at http://www.htdig.org
The only thing left to do is to modify the htdig.conf config file which was placed in CONFIG_DIR/htdig.conf. The Configuration manual has the details on how what attributes are needed.