
			INSTALLING DAP


GENERALITIES

This document concerns building and installing Dap from sources.

Dap will configure and build under a number of common Unix-like platforms.
The directions here are for GNU/Linux; the configure and build
for other platforms are similar.

Dap is a GNU program and is free software distributed under a
GNU-style copyleft. See the file COPYING for details.

GETTING AND UNPACKING THE SOURCES

The simplest way is to download the most recent `dap-x.y.tar.gz' package,

	gunzip -c dap-x.y.tar.gz | tar -xvf -

COMPILATION

Choose a place to install dap and its documentation.  Let's call this
place `DAP_HOME'.  Untar the source code.  This should create directories
`src', `doc', and `examples'.  

If you want the executables, includes, library, and info files installed
in subdirectories `bin', `include', `lib', and `info', respectively, of
`/usr/local', then simply issue the following commands:

	./configure
	make
        make install

Otherwise, edit `Makefile.in' to select a different place to install
and then type the above commands. Note: when DAP_HOME/src/dap.c
compiles, you will get a warning:

	implicit declaration of function `strcat'

and when DAP_HOME/src/dap0.c compiles, you will get a warning:

	implicit declaration of function `dap_main'

Ignore these warnings.  Now rehash.  

ENVIRONMENT

The following environment variables are used by Dap:

DAPEDITOR     for editing programs to run under Dap
DAPEDOPTS     options for that editor
DAPPAGER      for viewing tabular output from Dap
DAPPAGEOPTS   options for that pager
DAPCOMPILER   for compiling programs to run under Dap
DAPCOMPOPTS   options for that compiler
DAPVIEWER     for viewing graphical output from Dap
DAPVIEWOPTS   options for that viewer
DAPPP         path name for the Dap preprocessor
              (default: /usr/local/bin/dappp)
INCDIR        directory for compiler to find <dap.h>
              (default: /usr/local/include)
LIBDIR        directory for compiler to find libdap.a
              (default: /usr/local/lib)

All but the last three are further documented in the manual.

If your editor for programs to run under Dap does not run in
its own window, you should uncomment out the call to `waitpid'
at the end of the function `edrun' in `dap.c'.  Alternatively,
you can comment out the call to `edrun' entirely and just run
the editor on your own.

READING THE MANUAL

To read the manual in info, you will need to have `/usr/local/info' (or
whatever directory you installed the info file in) in your `INFOPATH'.
The following command (which you will probably want to put in your
shell's `rc' file) will do that:

	setenv INFOPATH ".:/usr/info:/usr/local/info"

Then issue the command:

	info dap

If you prefer dvi or html manuals, they can be made from the
file:

	DAP_HOME/doc/dap.texi

(See the documentation for texi2dvi, dvips, and texinfo.)

The manual will tell you how to run and use dap.  The program
and data files for the examples in the manual are in the
directory DAP_HOME/doc/examples.

MACHINE DEPENDENCY

Dap assumes that you have a machine with 64-bit double precision
floating point numbers conforming to the IEEE floating point
standard.  If that is not the case, then you may have to modify
`machdep.c'; good luck.

BUG REPORTS

Send bug reports to <bug-dap@gnu.org>
