$Id: INSTALL,v 1.1 1999/12/12 22:56:53 rogue Exp $

1.	Configure

Look through the beginning of "xforge.h". Currently, there are two user
configurable #defines, DSPDEV and DSPBUF, which set the default DSP
device and DSP buffer size (in bytes). Alternatively, they can be specified
in Makefile CFLAGS. The DSP device can be overridden with -D command line
option.

Edit the Makefile according to your needs. There are few sample entries,
Slackware 3.5.0 should work for most Linuxes and BSDs. Define -DOSSPLAY
in CFLAGS if you want to hear any sound. You must have the OSS sound
drivers installed; different flavours of Linux and the free BSDs have
the free version, and at least Unixware 7 has them, too.

If you are unable to compile with any of the provided entries, you are on
your own. Ask someone who knows about the system - the Xforge project
does NOT know, otherwise there would be entries for you in the Makefile.
But we are interested if you can figure out how to compile the thing and
send us the CC, CFLAGS, LDFLAGS and LIBS you used.

2.	make

Just type "make". Hopefully, everything goes fine. Again, if it does not,
we can do very little to help you. Try changing your CC to gcc if you have
gcc - the development is done with the GNU compiler so it should work,
at least version 2.7.2.3.

3.	Try it out

Before messing up the already working stuff, type

% XENVIRONMENT=Xforge.ad ./xforge

A window should be opened, with an empty wave buffer. Try some things
out like opening waves and some simple effects. If everything is fine,
there is a good chance that Xforge is actually working.

4.	Install

Now copy xforge somewhere in your search path and Xforge.ad to your
app-defaults directory as "Xforge". For system-wide install, become
root first and check that xforge is mode 755, and Xforge is mode 644.

Actual install target will be provided when Xforge is ready for release.
