SUPPORTED PLATFORMS
===================
(eg: I've heard someone has compiled it on...)
(    that is the original code did .. but I think this new one should work
     just fine)

- intel/Linux (Primary Platform)
- intel/FreeBSD (Primary Platform as well now ;-)
- MKLinux
- alpha/Linux
- intel/NetBSD
- HP-UX 10.20
- Solaris (partly)

Patches to make it work on other platform sound drivers are welcome!


REQUIREMENTS:
=============

The following software is required to use wmsound-0.9.1
- Any version above WindowMaker 0.14.0
  wmsound-0.9.1 may work with older versions of WindowMaker, but
  have not been tested.
  
  To be honest I don't knwo how far back the WINGs-functioncalls we use
  here will work. Please send in reports for as early versions as possible
  (We're not using any WINGs-GUI-calls just some handy functions)


INSTALLATION:
=============
With Pre-0.20.2 (I think) Window Maker ... --enable-sound is now automatically
enabled so configuring Window Maker with the --enable-sound option is no longer
needed. If you're running an older Window Maker version:

First make sure that you have ran ./configure --enable-sound when 
you built WindowMaker.  If you have not done this stop what you are
doing and go back to your WindowMaker source tree and run the following:

rm config.cache config.log
./configure --enable-sound (and whatever other flags you throw)
make 
cp src/wmaker /usr/local/bin (do not attempt this while wmaker is running)
restart X

--continue on to below----
In order to enable Solaris support you need to modify the following:

lib/Imakefile - lines for Solaris Uncomment out the below line - 
XCOMM STD_INCLUDES = -I/usr/openwin/include -I/usr/local/include
XCOMM EXTRA_DEFINES = -DSVR4

Make sure and comment out the line
EXTRA_DEFINES = -DOSS_SOUND

This is the Imakefile that has the other defines for esd and HP-UX as well.

--continue on---
./Install

The above script will generate an initial WMSound domain file.
The generated domain file is based on the default sound package.
Just make sure You copy this file to the Window Maker Global Defaults Path
(most likely /usr/local/share/WindowMaker/Defaults).
We're not doing this automatically as e.g. the FreeBSD port of Window Maker
installs itself in /usr/X11R6


Make sure and grab the default sound package from :

http://www.frontiernet.net/~southgat/wmsound

After running this just run wmsound & from a xterm and dock it and 
right click and select settings and click on "start when WindowMaker is
started"

Or optionally you can run wmsound --hidden.  In order for this to work
you need to add the following to your autostart script :

wmsound --hidden &

(*********************** WARNING ********************************)
There is a bug in if you are in the habit of restarting WindowMaker it 
will launch another copy of wmsound.

Also you can set the "Command for files dropped with DND" to
nmaker %d this will use the nmaker util for playing sounds through the
server.
(Right now it seems nmaker requires Full Paths for the soundfiles.
 We're looking to see if I can "fix" this behaviour in future versions).

Another tip you can use nmaker(tm) to handle wav and au sounds from netscape.
To do this start up netscape click on "Edit" Then click on preferences.  This 
will pop up the preferences window.  Then click on the triangle next to 
"Navigator" click on Applications.  Scroll through the list untill you see
WAV.  Click on it then click the edit button.  Next click on Application: radio
button and type in nmaker %s. Press the OK button then do the same for ULAW 
if you like.  Then press ok and you should be set.
(Enjoy)

Download for sound packages are :

http://www.frontiernet.net/~southgat/wmsound/sounds/index.shtml

Download WSoundPrefs a Utility to configure wmsound @ 
ftp://shadowmere.student.utwente.nl

(This is a replacement for the older WMSound Setup written by the same author)
