This  marks  the  first release of xltcdplay, version 1.7.  xltcdplay is
short for:

	X LessTif CD Player


HISTORY
-------

I  found  myself  in  X all of the time  once some badly needed upgrades
were done. But I continued to rely on text mode tools  to control my all
important productivity tool - CD audio! This simply was not acceptable.

Then  the  alpha release of LessTif came out in August.  Since then I've
waited  with  great anticipation of the first "real" release of LessTif.
Well  folks,  its  finally  here,  and  that makes all kinds of exciting
projects like xltcdplay possible. Thanks guys.


PROGRAM FEATURES
----------------

This  tool  is  designed  as  a  control  panel  that  is functional and
conveniant. It supports the following features:

	1. Direct track select buttons from 1 to 18.

	2. Spin buttons for higher track numbers: both forward
	   and reverse. Reversing from 1 goes to the last track.

	3. Track display window:

		- real time track number is displayed
		- minutes and seconds played so far are displayed

	4. Control Buttons:

		EJECT
		STOP
		PAUSE
		<< (Fast back)
		>> (Fast forward)
		PLAY

	5. Track progress indicator (imagine scrollbar without
	   buttons).

	6. General info displayed above track progress indicator:

	   Track mm:ss (CD mm:ss, xx Audio & yy Data Tracks)

		mm = minutes
		ss = seconds
		xx = # of audio tracks on CD
		yy = # of data tracks on CD

	7. Volume Scroll Bar Controls(!) Left and Right.

		(this depends on CD-ROM drive hardware however)

	8. File->Error Report Dialogs toggle:

		By default when your CD-ROM drive raises an error during
		operation, a MOTIF dialog box is used to alert you
		of the trouble.  However you can toggle this feature.

		I found this helpful for my NEC Multispin 6V that seems to
		get into a snit once in a while. After a lot of fiddling, it
		eventually comes around, but I don't need the dialog boxes
		when I wrestle to get it out of its bad mood.

		NOTE: if you run xltcdplay from an xterm session, the errors
		continue to be reported to stderr, so this can be a
		conveniant way to see all the error messages.

	9. One final feature is that this tool is easy to compile and install.
	   There is not that much source code in this utility, and there is
	   absolutely no need to install any resource files. Just "make"
	   and "make install" pretty much covers it.
	

LIMITATIONS
-----------

	Please read README.VOLUME.

KNOWN BUGS
----------

	(These are as of LessTif 0.75a)

	1. The main window is not supposed to be resizable. It appears
	   that	LessTif is ignoring the XmNallowShellResize = FALSE
	   resource setting.

	2. Track Display Window:

		a) The cursor remains visible: due to LessTif bug that seems to
		   ignore the XmNcursorPositionVisible = FALSE setting. This
		   appears to be a LessTif bug.

		b) The window remains editable: this is due to the resource
		   setting XmNeditable = FALSE being ignored. This appears
		   again to be a LessTif bug.

	3. Selecting say track 3 by pussing button [3] and then pressing
	   [PAUSE] followed by [PLAY] will unexpectedly play say track 1.

	   This is the result of a tradeoff I had to make. The control
	   panel is almost totally driven by the device driver itself.
	   However, when selecting tracks that information is kept in
	   the application and not the driver. Pressing [PAUSE] causes
	   the application to use the driver's idea of position instead
	   of the applications (hopefully some of you will know what I
	   mean by all of this).

	   The avoidance procedure for this is to start the device
	   playing when I select a track, and then immediately stop.
	   Then both driver and application would be in sync. However,
	   doing so is very time consuming making the track selection
	   too sluggish. So I opted to put up with this very seldom
	   seen annoyance, in favour of a responsive control panel.

	4. Help->About dialog:

 	   The resource setting XmNmessageAlignment = XmALIGNMENT_CENTER
	   appears to work, but I noticed that the centering is off by
	   about 0.25 inches. In otherwords, it crowds the right hand
	   side of the dialog box. This appears to be a LessTif problem.

	5. Dialog boxes in general:

	   The dialog boxes often appear quite a distance from the
	   main window. Under real MOTIF applications, the dialogs
	   usually overlap the main window. This appears to be
	   something that the LessTif group can investigate.
