Installation Instructions for DAP
---------------------------------

Notes for the impatient :) Essentially to build the sources you'll have to
ensure a few things:

  * You must have a full gcc/g++ installation (or CC on IRIX).
  * On everything other than SGI you'll need OSS drivers and headers to be
    installed correctly (these normally come as standard on Linux).
  * You must have XForms 1.0 installed correctly. This means:
    + The XForms include file (forms.h) must be in your include path.
    + The XForms library files (libforms*) must be in your library path. Note
      that on my system I found that I needed to manually add /usr/X11R6/lib to
      my LD_LIBRARY_PATH environment variable.
  * You must define OTHER_INCLUDE_DIR and OTHER_LIBRARY_DIR environment
    variables. On my home setup, where everything is installed correctly I
    simply set these to "." but at work (where I don't have root access to
    install XForms properly) I set these to the appropriate directories housing
    the XForms include and library directories respectively.
  * You should then type 'make -f Makefile.[architecture]' in the top level DAP
    directory to build DAP. On my setup I type "make -f Makefile.linux".
  * This should result in an executable called DAP being generated in the main
    directory.

1/. Building the Sources

If you have downloaded a binary release you will not need to build DAP from its
sources so jump straight to the next section. If not then you've got some work
ahead of you before you see DAP appearing on your lovely big monitor screen !!

First off you'll need an ANSI C/C++ compiler such as gcc/g++ (or CC on IRIX).
If you are using gcc make sure you have installed the C++ libraries contained
in the libg++ distribution in addition to gcc. These will normally be installed
already. If you plan to use gcc/g++ on IRIX you'll need to edit all the
Makefile.sg files. You'll see commented out sections for gcc - simply copy the
relevant entries from the commented out section to the actual definition
section at the top (let me know if you have problems).

Now you'll need the XForms distribution to be installed. I heartily recommend
using the latest release version (1.0) although newer versions should be OK as
well. There have been problems in the past with the tooltips system employed by
DAP and certain versions of XForms but you can always turn the tooltips off if
they prove to be problematic.

Follow the instructions provided with XForms to install the package. See
http://world.std.com/~xforms and http://savannah.nongnu.org/projects/xforms/
for further details on XForms. Note that on my system I found that I needed to
manually add /usr/X11R6/lib to my LD_LIBRARY_PATH environment variable. In
addition you may have to install the XPM library to get XForms to run
correctly. See the XForms documentation for further details. The XPM library
can normally be found at
ftp://src.doc.ic.ac.uk/unix/Linux/sunsite.unc-mirror/libs/X

If you are compiling on Linux, NetBSD or Solaris you will also require the Open
Sound System (OSS) audio drivers and headers to be installed on your machine.
These drivers are normally supplied with Linux but NetBSD and Solaris users may
have to install them manually. The older VoxWare drivers (upon which the OSS
drivers are based) may also work but are untested. See http://www.opensound.com
for further details on OSS.

Now you're nearly there :) In each of the DAP directories there are five
makefiles - one for each architecture on which DAP is currently supported. Note
the makefiles in the sound directory are NOT directly used for the main DAP
build.

The five makefiles in each of the main directories are :-

  Makefile.alpha  - makefile used for Linux/Alpha derivatives
  Makefile.linux  - makefile used for Linux/i386 derivatives
  Makefile.netbsd - makefile used for NetBSD/i386 derivatives
  Makefile.sg     - makefile used for IRIX derivatives
  Makefile.sun    - makefile used for Solaris derivatives

I really ought to set up imakefiles to generate these for you but until I work
out how xmkmf actually works you're stuck with these more basic renditions :(
However if anyone out there wants to have a go....

Also have a look at the makefiles for your architecture and check that you
don't need to make any manual amendments (eg IRIX users may wish to use the
gcc/g++ compiler rather than CC - see the Makefile.sg files for the settings).
The more usual changes are the adding of extra include or library directories
(to INCDIR and LIBDIR respectively).

Now go to the top level DAP directory and type 'make -f
Makefile.[architecture]'. I usually have the following aliases set :-

  alias m make -f Makefile.alpha  (on Linux/Alpha)
  alias m make -f Makefile.linux  (on Linux/i386)
  alias m make -f Makefile.netbsd (on NetBSD/i386)
  alias m make -f Makefile.sg     (on IRIX)
  alias m make -f Makefile.sun    (on Solaris)

Hopefully DAP will now compile with no warnings and you'll be left with a DAP
executable in the main directory. If anything goes wrong note in which
directory the compilation failed and check the appropriate makefile in the
relevant directory. Make sure you have modified any directory locations as
necessary. If all else fails give me an email and I'll do my best to sort
things out :)

2/. Installing the Software

In the main directory there should be an executable called DAP. You should be
able to run this directly. However I recommend copying this executable to
/usr/local/bin (or somewhere else in the default PATH). Make sure any older
versions of DAP aren't still hanging around somewhere - otherwise when you type
DAP you might be running an old version :( Best way of checking is to type
"which DAP" at the shell prompt and make sure the right DAP executable is
listed.

I also recommend copying the example effects (in the effects directory) to a
globally visible directory such as /usr/local/dap/effects.

If you have any trouble running DAP ensure that the correct version of XForms
is installed correctly (1.0 for the precompiled binaries) which basically
means having the libforms.so.089 file either in /usr/lib or somewhere in the
environment variable LD_LIBRARY_PATH. There are further details about this in
the previous section about building the sources.

If you are still having troubles then let me know your exact configuration
(machine, operating system, memory, version of XForms, compiler, etc) and I'll
try my best to get things sorted out for you.

Good luck !!

TicH

--------------------------------------------------------------------------------
                   Name  - Richard Kent (Tich)
                   EMail - richardk@cee.hw.ac.uk
                   WWW   - http://www.cee.hw.ac.uk/~richardk
--------------------------------------------------------------------------------
