========================================================================
                                ascd 0.7
						  
			a CD player for Afterstep and Window Maker
========================================================================

MAINTAINERS

                 Rob Malda:
               - email: malda@cs.hope.edu
               - WWW:   http://www.cs.hope.edu/~malda/

                 Denis Bourez:
               - email: dbourez@dial.oleane.com
               - WWW:   http://worlserver.oleane.com/rsn/

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

DESCRIPTION:

ascd is a CD player 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). This is ascd.

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 src and merged it with the ascd 0.4 interface.

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

INSTALLATION: (Tested on Linux i386 2.0.X, 2.1.X and FreeBSD i386 2.2.X)

xmkmf
make

One compiled, test the program:

    ./ascd -d /dev/xxxyyy
    
where xxxyyy is the device for your CDROM drive. The default (in ascd+)
is /dev/cdrom. To see all command line options, type:

    ./ascd -h

Installation for Afterstep:

    Add a line in your ~/.steprc file:

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

Installation for Window Maker:

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

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

HOW TO USE IT:

ascd+ only has a few buttons but combined with the three buttons of the
mouse, they offer a lot of feature.

This is what ascd looks like:

  +----------------------------------------------+
  | <A>                                          |
  | Track/Disk Ellapsed/Remaining Display        |
  |                                              |
  |                                              |
  |                                              |
  +----------------------------------------------+
    
  +-------------+  +-------------+  +------------+
  |     <B>     |  |     <C>     |  | <D> Track  |
  | Play,       |  | Stop,       |  | Progress.  |
  | Pause and   |  | Eject       |  | Bar        |
  | Intro Scan  |  |             |  |            |
  |             |  |             |  |            |
  |             |  |             |  |            |
  +-------------+  +-------------+  |            |
                                    |            |
  +-------------+  +-------------+  |            |
  |     <E>     |  |     <F>     |  |            |
  |    Back     |  |   Track     |  |            |
  +-------------+  |   Number    |  |            |
  +-------------+  |   Display   |  |            |
  |     <G>     |  |             |  |            |
  |    Next     |  |             |  |            |
  +-------------+  +-------------+  +------------+

  <A> Time Display: 
  
      Show the ellapsed time of the track. But by clicking
	 on the display with the left button, several 
	 informations will be displayed :

        - elapsed time of the current track; (nothing)
        - remaining time of the current track; ("-")
        - elapsed time of the whole disk; ("o")
        - remaining time of the whole disk; ("o" on "-")
	   
	 Clicking on the display with the right button cuts 
	 the volume. Another click restore the initial 
	 volume. (the 'cut' volume can be set with the '-v'
	 command line option)
	 
   <B> Play/Pause:
   
       when the CD is stopped, clicking with the right button on
       this starts the "Intro Scan" mode. ascd plays the first
       ten seconds of each track. This value can be changed with
       the "-c" command line option (see below)

   <C> Stop/Eject:
   
       Stop the CD while playing; Eject when stopped.

   <D> Track Progression Bar:

       This bar shows the progression of the track. When clicking on it,
	  you can....:

       - left button  : direct access to a portion of the track
	  - mid button   : restart the current track
	  - right button : goes to the loop start locator (see <F>)

   <E> and <G> Previous/Next track:
   
       These buttons support new functions, depending on the way
       you click on them:

       - left button  : go to previous/next track, nothing changed.
       - mid button   : go to first/last track of the disk.
       - right button : review/cue mode, by 10 seconds steps. As
         for the intro scan mode, this value can be changed with
         the "-c" option.

   <F> Track Number Display:

       Clicking on the display activates the loop function: you can
	  repeat a portion of the track. You have to define the start
	  position and the end position, then activate the loop. This
	  feature can be very usefull, for instance, for musician practice.

       loop function:

       - left button  : loop start locator = current position;
       - right button : loop end locator = current position;
       - mid button   : (des)activate the loop.

========================================================================
Denis Bourez, 97/09/05
