		    INSTALLATION INSTRUCTIONS
		       wavplay-1.3.tar.gz
		      Warren W. Gay VE3WWG
			ve3wwg@vaxxine.com
		     Wed Sep 16 17:41:05 1998

1.	Find a suitable directory to start from (best done from a
	non root account for overall safety:

		$ cd $HOME

		$ tar tzvf wavplay-1.3.tar.gz | less

	This displays the contents of the archive (you should always
	do this before unpacking a tar file).

2.	Unpack the archive:

		$ tar xzvf wavplay-1.3.tar.gz

	This creates a subdirectory ./wavplay-1.3 where all the
	extracted files should go.

3.	Change to the new directory:

		$ cd ./wavplay-1.3

4.	Make some decisions about this install (there are
	more than these, but these are the important ones):

	4.1 Are you installing everything (default)? Or
	    are you installing only wavplay and wavrec,
	    because you can't support X, or lack MOTIF/LessTif
	    libraries.

	    (just decide at this point)

	4.2 What CPU(s) will this software run on? If it is to
	    run on any platform (or 386), then comment out the
	    line that specifies 'CPU=-m486'.

	4.3 Where do you want wavplay, wavrec and optionally
	    xltwavplay executables intalled? By default:

		INSTDIR=/usr/local/bin

	4.4 Where is your sound interface device installed?
	    Default is DSPPATH= -DAUDIODEV=\"/dev/dsp\"
	    (ie. /dev/dsp)

	IF INSTALLING XLTWAVPLAY :

	4.5 If installing X based xltwavplay, do you want
	    to compile it with builtin fallback resources
	    (default and easiest way)?  Or instead, would
	    you rather have the resource file installed for
	    it so that you can customize colours and fonts
	    etc.? (See USERES=-DINSTALLED_RESOURCE_FILE)

	4.6 If installing the resource file in 4.5, where
	    would you like it installed? Default is:

		RESDIR=/usr/X11R6/lib/X11/app-defaults

	4.7 If installing xltwavplay, do you want it to
	    be EDITRES capable? If not sure, leave it as
	    default (yes). (See NOEDITRES=-DNO_EDITRES,
	    and LIBXMU=-lXmu)

	4.8 You may need to alter the library search
	    paths to pick up your MOTIF/LessTif libraries.
	    Review the macro XLDOPTS= in the Makefile.

	4.9 You may also need to fix your symlinks for
	    X and LessTif/MOTIF include files. Alternatively
	    you may just want to edit the Makefile macro
	    CUSTINCL= to specify some custom include file
	    directories to the compiler.

5.	Edit the Makefile to reflect your decisions above:

		$ emacs Makefile

	or	$ vi Makefile

	Each configurable item has comment text above it for
	explanation, so I won't repeat it all here.

6.	Check Makefile settings: some things _MUST_ be set
	properly before the make can be successful:

	CPU=-m486		Change you're using a 386
				(by commenting it out)

	INSTDIR=/usr/local/bin	Change if you don't want to
				install here!

	RESDIR=/usr/X11R6/lib/X11/app-defaults
				Change this if you chose to
				install a resource file for
				xltwavplay (if you're not
				installing xltwavplay, then
				ignore this)
	
	DSPPATH=-DAUDIODEV=\"/dev/dsp\"
				Change this line if your
				audio device is not /dev/dsp

	DSPLOCKS= -DAUDIOLCK=0x33333333
				Change this if you want to use
				a different IPC Key for your
				semaphores. Normally, this
				default is probably fine.

	XLDOPTS= 		Most will want to alter this
				macro to specify the correct
				directories for the libraries
				needed (if you are compiling
				the X based client only).

7.	Before starting, and/or if you've made changes to the
	Makefile, start clean by doing:

		$ make clobber

8.	If you are making all of the source, just type:

		$ make

	or	$ make all

	This should compile wavplay, wavrec and xltwavplay. If
	you have problems linking xltwavplay, check the top
	portion of the Makefile. There are some hints about
	things to check there.

	If you don't want the X Window client, then use:

		$ make no_x

9.	Gain install privileges:

		$ su -

	(or login in as root)

10.A	If installing everything, just type:

		# make install

	If not installing the X based client program, then
	use:

		# make install_no_x


10.B	If you compiled with the SCHED_PRIORITY macro
	defined in the Makefile, then you'll be asked
	to make the program setuid root. You can ignore
	this (the program will emit a small warning to
	stderr however).

		# make setuid_root


11.A	Adjust your volume level(s). My system always boots
	up with max volume (due to a startup script I use).
	Checking the volume first may save your ears and
	your speakers too.

11.B	Test. Try wavplay on an existing wav file:

		$ wavplay diddly.wav

	If you don't hear anything, please check your mixer
	(volume settings etc.)

	Also check that you don't have another older one
	installed:

		$ wavplay --version

	should indicate version 1.3.

	Make sure you're invoking the correct executable
	another way:

		$ type wavplay
		wavplay is /usr/local/bin/wavplay

	You should see something like the above. This shows you
	what is used when wavplay is typed at the command prompt.


12.	Test xltwavplay (if you compiled it)

	From an xterm session try:

		$ xltwavplay &

	If this fails to run, it might be because it cannot
	access a shared library. For example, if you've just
	installed LessTif into say /usr/local/lesstif/lib
	then you may need to edit your /etc/ld.so.conf
	file. Just add a line of the form:

	/usr/local/lesstif/lib

	to it, and then run /sbin/ldconfig -v to
	have the change registered.

	You may need to do this for other X libraries
	if you've never compiled other X programs
	before. For example, you might also need:

	/usr/X11R6/lib

	added to /etc/ld.so.conf as well (don't
	forget to run /sbin/ldconfig).

	Both pathnames above are examples only,
	and your mileage may vary.

13.	Read the file BUGS! 

14.	Enjoy.

End INSTALL
