ascd/ascd/README

   1 ========================================================================
   2                                  AScd 0.13
   3                  CD player for Afterstep and Window Maker
   4 ========================================================================
   5
   6 MAINTAINER:
   7
   8                  Denis Bourez:
   9                - email: denis@rsn.fdn.fr
  10                - AScd home page: http://worldserver.oleane.com/rsn/
  11
  12 AScd ORIGINAL AUTHOR:
  13
  14                  Rob Malda:
  15                - email: malda@slashdot.org
  16                - WWW: http://CmdrTaco.net/
  17
  18 ========================================================================
  19
  20 DESCRIPTION:
  21
  22 AScd is a CD player that can be "docked" on the Afterstep Wharf or the
  23 Window Maker dock. It uses libworkman to access CD drivers.
  24
  25 ========================================================================
  26
  27 HISTORY:
  28
  29 AScd 0.1 -> 0.6
  30 ---------------
  31
  32 The original code was taken by Rob Malda from asclock (Afterstep wharf
  33 module, by Beat Christen <bchriste@iiic.ethz.ch>) and from workbone (CD
  34 driver).
  35
  36 AScd 0.7 -> 0.9
  37 ---------------
  38
  39 I removed all the workbone code (Linux specific): ascd could then be compiled
  40 on several UN*X flavors. I took a big part or the WorkMan (see at the end of
  41 this text) src and merged it with the ascd 0.4 interface. The WorkMan code
  42 was compiled as a library.
  43
  44 AScd >= 0.10
  45 ------------
  46
  47 WorkMan has splitted in 2 parts: the ui and the lib, named libworkman. So,
  48 AScd uses this brand new lib, instead of the one which was included in the
  49 AScd's archive. WorkMan's maintainer is Dirk Foersterling
  50 (milliByte@DeathsDoor.com).
  51
  52 AScd >= 0.12
  53 ------------
  54
  55 AScd no longer includes the pixmaps in the source files. It is now possible
  56 to change the pixmaps theme at run time. AScd now needs a directory where
  57 to store the pixmaps. The default is /usr/local/share/AScd.
  58
  59 AScd >= 0.13
  60 ------------
  61
  62 The theme files are now fully customizable. All theme directories are
  63 installed by default in /usr/local/share/AScd/Themes.
  64
  65 ========================================================================
  66                              HOW TO COMPILE????
  67 ========================================================================
  68
  69 You need to download, compile and install the WorkMan library. Please
  70 use the 99/05/05 snapshot wish can be found on the AScd's home page or
  71 on the primary ftp site for WorkMan:
  72
  73 ftp://ftp.midwinter.com/WorkMan/snapshots/
  74
  75 ========================================================================
  76                               CONFIGURATION
  77 ========================================================================
  78
  79 Run ./configure
  80
  81 This script will ask you a few questions about compilation-time
  82 options, and generate a "config.h" file matching your choices. The
  83 script will then run xmkmf to generate the Makefile.
  84
  85 ========================================================================
  86                           COMPILATION/INSTALLATION
  87 ========================================================================
  88
  89 IMPORTANT NOTE: if you're upgrading from AScd 0.12, please remove
  90 everything in the AScd default directory (/usr/local/share/AScd) as the
  91 theme files are *not* compatible.
  92
  93     make
  94
  95   - If you want to try the program, just type
  96
  97     ./ascd
  98
  99     (try './ascd -help' to see the commandline options)
 100
 101     If everything is ok, you can install the program and the
 102     man page:
 103
 104     make install
 105     make install.man
 106
 107
 108 * installation for AfterStep
 109   --------------------------
 110
 111   Add a line in your ~/.steprc file:
 112
 113   *Wharf - - Swallow "ascd" /usr/local/bin/ascd -device /dev/wcd0a &
 114
 115   (customized to your system settings of course!)
 116
 117 * installation for Window Maker
 118   -----------------------------
 119
 120   Launch ascd with the "+w" option.
 121   Dock ascd by dragging it to the dock.
 122
 123 ========================================================================
 124                                 CREDITS
 125 ========================================================================
 126
 127   Denis Bourez (denis@rsn.fdn.fr) http://worldserver.oleane.com/rsn/
 128   Rob Malda (malda@slashdot.org)  http://CmdrTaco.net/
 129
 130   The 0.12 *digits.xpm were taken and modified from wmitime, an excellent
 131   clock applet for Window Maker. Wmitime was written by Dave Clark
 132   (clarkd@skynet.ca) More info at: http://www.neotokyo.org. I added the
 133   lower case letters.
 134
 135   The new 0.13 default font is fully 8bit compatible! It has been drawn
 136   by Stefan Zeiger (szeiger@novocode.com).
 137 ========================================================================
 138                                                 Denis Bourez, 05/17/1999