Configuring and compiling the software

1. First, unpack your distribution. We provide source code in a tar file which was compressed using gzip. The code can be extracted into a directory unpackdir using

   mkdir unpackdir
   cd unpackdir
   tar zxvf gnats-3.2.tar.z
   

   The sources reside in a directory called `gnats-3.2' when unpacked. We call this the top level of the source directory, or srcdir. The sources for the GNATS tools are in the subdirectory `gnats-3.2/gnats/*'. Lists of files included in the distribution are in each directory in the file `MANIFEST'.
2. You may wish to alter the installation directory for the Emacs lisp files. If your Emacs lisp library is not in `prefix/lib/emacs/lisp', edit the files

   srcdir/gnats/Makefile.in   and
   srcdir/send-pr/Makefile.in
   

   Change the variable `lispdir' from `$(datadir)/emacs/lisp' to the directory containing your Emacs lisp library. For information on prefix, see section prefix.
3. Run configure. You can nearly always run configure with the command

   ./configure --with-full-gnats
   

   and the "Right Thing" happens:
   • GNATS is configured in the same directory you unpacked it in;
   • when built, GNATS runs on the machine you're building it on;
   • when installed, files are installed under `/usr/local' (see section Where GNATS lives).
   • GNATS operates by default behavior (see section Default behavior).
   The full usage for configure is:

   configure [ --with-full-gnats ]
             [ --prefix=prefix ]
             [ --exec-prefix=exec-prefix ]
             [ --with-gnats-root=GNATS_ROOT ]
             [ --verbose ]
   

   --with-full-gnats

   All programs are to be built; this includes the user utilities, the administrative utilities, and the internal utilities. Use this when configuring the utilities for the machine where GNATS is to run. Omit it when building only the user utilities for other machines on your network; see section Installing the user tools.

   --prefix=prefix

   All host-independent programs and files are to be installed under prefix. (Host-dependent programs and files are also installed in prefix by default.) The default for prefix is `/usr/local'. See section Where GNATS lives.

   --exec-prefix=exec-prefix

   All host-dependent programs and files are to be installed under exec-prefix. The default for exec-prefix is prefix. See section Where GNATS lives.

   --with-gnats-root=GNATS_ROOT

   The database and its data files are to be installed into GNATS_ROOT. The default for GNATS_ROOT is `prefix/lib/gnats/gnats-db'. See section Where GNATS lives.

   --verbose

   Give verbose output while configure runs.

   See section `Using configure' in Cygnus configure. You can build GNATS in a different directory (objdir) from the source code by calling the configure program from the new directory, as in

   mkdir objdir
   cd objdir
   srcdir/configure ...
   make all
   

   By default, configure compiles the programs in the same directory as the sources (srcdir). Emacs lisp files are byte-compiled if make can find Emacs on your local system.
4. Run

   make all info
   

   from the directory where configure created a `Makefile'. (This may not be the same directory as the source directory.) These targets indicate:

   all

   Compile all programs

   info

   Create `info' files using makeinfo.

Go to the first, previous, next, last section, table of contents.