
   Copyright (c) 1989, 1991, 1992 by Digital Equipment Corporation

   Permission to use, copy, modify, and distribute this software for any
   purpose and without fee is hereby granted, provided that the above
   copyright notice and this permission notice appear in all copies, and that
   the name of Digital Equipment Corporation not be used in advertising or
   publicity pertaining to distribution of the document or software without
   specific, written prior permission.

   Digital Equipment Corporation makes no representations about the suitability
   of the software described herein for any purpose.  It is provided "as is"
   without express or implied warranty.

   The software was originally written by Mark Clement and was later 
   substantially revised by Mark Longo, both of Digital Equipment Corp.

STARTING OUT
~~~~~~~~~~~~
	
	Dependencies:
	-------------

	You must have an RRD42 CDROM attached to your DECstation.  
	You must be running Ultrix 4.2 (though the ULTRIX binary for xcd 
	mostly works right on OSF/1 systems with the CDROM driver).


	If you have 100 DPI display hardware:
	-------------------------------------

	Some DECstations use 100 dots-per-inch displays.  If you're using 
	one of these displays, xcd's status display area will be incorrectly 
	sized.  In order to correct this condition, perform the following: 

	csh> su
	csh> rm /usr/lib/X11/uid/xcd.uid
	csh> ln -s /usr/lib/X11/uid/xcd.uid.100dpi /usr/lib/X11/uid/xcd.uid


	Finding out the device name of your CDROM player:
	-------------------------------------------------

	You need to know the character special device for the CD ROM.
	To find out the name of this file, you can use the locate_cd
	program in this distribution.  Simply type 'locate_cd'.  Here's
	what output looks like if you have an RRD42

		csh> locate_cd
		/dev/rrz4c

	You may see a different number between the 'rrz' and the 'c'.  If 
	you don't have an RRD42, here's the output you get

		csh> locate_cd
		It appears that an RRD42 is not installed on this system.

	We'll use /dev/rrz4c as the CD ROM device in examples below.

	
	Setting device permissions:
	---------------------------

	Permissions on the CD device file returned by locate_cd should
	be 666.  They are not set this way by default, so as superuser
	you should

		csh> chmod 666 /dev/rrz4c

	You need to tell xcd where the CD ROM drive is.  You can do this
	by either setting the environment variable CDROM to the device
	returned by locate_cd, or by starting xcd with the -f option.
	For example:

	# using the environment variable
	csh> setenv CDROM /dev/rrz4c
	csh> xcd

	# using the '-f' option
	csh> xcd -f /dev/rrz4c


	Front panel buttons:
	--------------------

	Most of the buttons on the control panel are self-explanatory.
	One, however, may not be obvious.  The padlock button may be used
	to disable the eject button on the front of the RRD42.  This can
	be used to prevent someone from ripping off your CD.


	Insert a disk:
	--------------

	You should have the CD you want to listen to inserted in the
	drive before starting the xcd application.  If you do not, xcd 
	will take a few minutes to come up and you may get some error 
	messages.  It is safe to ignore these messages if you get them.


CUSTOMIZATION
~~~~~~~~~~~~~

	You may control some aspects of xcd's appearance by specifying
	xcd resources in your ~/.Xdefaults file.  Use the file "Xcd" as 
	a template.  In the binary kit, this file is found at :

		/usr/lib/X11/app-defaults/Xcd

	If you have the source kit, a motif UIL compiler, and a little 
	iniative, you can do a quite a bit of customization of xcd by 
	monkeying with the UIL file.  Most notable are customizations 
	of the number of "select" buttons/row, button size, and the 
	startup volume level.  See the makefile rule for "xcd.uid" 
	to see how to compile the UIL file.


Have fun!

