Previous Next Table of Contents

2. Installation

2.1 Obtaining the Distribution

I don't have enough disk space at my current ISP to host the distribution myself, so I am using some of the popular archive sites for Linux software. I will be distributing avdbtools in compressed tar format as well as Red Hat Package Manager (RPM) format. You should be able to get the distribution by anonymous ftp from the sites listed below. If the files are not there, check the respective Incoming directories.

2.2 Requirements

This software was developed and tested under Red Hat Linux, release 4.2. The requirements are relatively modest, you should be able to build and use this software under most any UNIX like environment with an Ansi C compiler (such as the Free Software Foundation's gcc compiler), a make utility, and the Bourne shell.

2.3 Configuration and Compilation

To build faaconv, follow these easy steps;

  1. Edit the Makefile and change the macros that are related to specification of the environment, assigning values appropriate to your situation. The only macros you should need to edit are; CC to specify your C compiler, and BINDIR, DOCDIR, LIBDIR, MANDIR to specify the directories where the executable, documentation, model coefficients, and man page, respectively, are to be installed.
  2. Run "make" to build the executable.
  3. Run "make install" to install the executable in BINDIR, and the model coefficients in LIBDIR.
  4. Run "make install-man" to install the man page in MANDIR and the user's guide in DOCDIR.

This user's guide and the man page can be found in the doc subdirectory of the source distribution tree. Both are written in SGML (Standard Generalized Markup Language) format. The SGML format documents are translatable into other useful and popular formats such as LaTeX (and dvi, postscript from there), as well as standard HTML. The converted formats are up to date with respect to the SGML versions when distributed. If you make changes to the master SGML format documents, you will need the Linuxdoc-SGML formatting system to update the other formats. It is available from ftp://ftp.cc.gatech.edu/pub/people/gregh/linuxdoc-sgml/


Previous Next Table of Contents