========================================================================
                                  ascd

                  CD player for Afterstep and WindowMaker
========================================================================

MAINTAINERS

                 Denis Bourez:
               - email: denis@rsn.fdn.fr
               - WWW:   http://worldserver.oleane.com/rsn/

                 Rob Malda:
               - email: malda@slashdot.org
               - WWW:   http://CmdrTaco.net/

========================================================================

DESCRIPTION:

ascd is a CD player and mixer that can be "docked" on the Afterstep
Wharf or the Window Maker dock.

========================================================================

CREDITS:

The original code was taken by Rob Malda from asclock (Afterstep wharf
module, by Beat Christen <bchriste@iiic.ethz.ch>) and from workbone (CD
driver). I - Denis - removed all the workbone code (Linux specific):
ascd can now be compiled on several UN*X flavors. I took a big part or
the WorkMan (see at the end of this text) src and merged it with the
ascd 0.4 interface.

It is known to run without (or with small!) changes on:

- FreeBSD 2.2 (development platform)
- FreeBSD 3.0
- Linux 2.0
- Solaris 2.6 SPARC, gcc 2.8.1
- Solaris 7 i386 gcc
- AIX 4.2/4.3

========================================================================
                                 WARNING
========================================================================

If you're upgrading from ascd <= 0.8 and using WindowMaker please note
that the "withdrawn" command is now "+w" and not "-w". If you've docked
ascd with the "-w" commandline option, you *have* to change this or ascd
0.9 won't work properly!

========================================================================
                              CONFIGURATION
========================================================================

Edit the "config.h" file in order to change the default values used by 
ascd:

  - where to install the library, the program and the manpage
  - the default devices
  - if you wish to include the mixer module (default is no mixer)
  - the default colors used for the LEDs
  - if you wish to compile the libworkman as a shared lib.

(you may also change the default paths defined in default-dirs)

========================================================================
                          COMPILATION/INSTALLATION
========================================================================

  - Type:

    xmkmf -a

  - and then:

    make
  
  - If you want to try the program, just type
    
    ./ascd/ascd
    
    (try './ascd/ascd -help' to see the commandline options)

    If everything is ok, you can install the program and the
    man page:
    
    make install
    make install.man


* installation for AfterStep
  --------------------------

  Add a line in your ~/.steprc file:

  *Wharf - - Swallow "ascd" /usr/local/bin/ascd -device /dev/wcd0a &

  (customized to your system settings of course!)
  
* installation for WindowMaker
  ----------------------------

  Launch ascd with the "+w" option.
  Dock ascd by dragging it to the dock.

========================================================================
                                CREDITS
========================================================================

  Rob Malda (malda@slashdot.org)  http://CmdrTaco.net/
  Denis Bourez (denis@rsn.fdn.fr) http://worldserver.oleane.com/rsn/

  Based on WorkMan cd-player. WorkMan's maintainer is Dirk
  Foersterling (milliByte@DeathsDoor.com).

  More details in the CREDITS.WorkMan file

  To download WorkMan: ftp://ftp.midwinter.com/WorkMan 

========================================================================
                                                Denis Bourez, 02/09/1999
