X LessTif CD Play Version 

	Copyright (C) 1997  Warren W. Gay VE3WWG

This  program is free software; you can redistribute it and/or modify it
under the  terms  of  the GNU General Public License as published by the
Free Software Foundation version 2 of the License.

This  program  is  distributed  in  the hope that it will be useful, but
WITHOUT   ANY   WARRANTY;   without   even  the   implied   warranty  of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General
Public License for more details (see enclosed file COPYING).

You  should have received a copy of the GNU General Public License along
with this  program; if not, write to the Free Software Foundation, Inc.,
675 Mass Ave, Cambridge, MA 02139, USA.

Send correspondance to:

	Warren W. Gay VE3WWG
	5536 Montevideo Road #17
	Mississauga, Ontario L5N 2P4

Email:
	wwg@ica.net			(current ISP of the month :-) )
	bx249@freenet.toronto.on.ca	(backup)

------------------------------------------------------------------------

Prerequesites:

1.	This has been tested on LINUX Kernel 2.0.23 using GCC 2.7.2.
	The  kernel  revision  will  likely  have a  bearing  on the
	ioctl()  calls used by CD-ROM devices.  I'm too lazy to look
	this  up, but you should be safe if you're running 1.2.13 or
	later.

2.	X  Server  installed  (XFree86),  since  this  is an X-based
	application  only,  even  though  cdrom.cpp  could  be  used
	independantly.

3.	LessTif shared library installed. You must use version 0.75a
	or later. Version 0.75 (without the 'a') had a small problem
	with  XmForm  which did  not successfully layout the widgets
	quite right, though it is useable (just uglier).

	Please make sure all C, C++ and LessTif shared libraries are
	properly  installed.  Don't forget to use ldconfig if you've
	made library changes.

	Alternatively, if you've purchased MOTIF, then you should be
	able  to  use  that  instead (I  was  not able to test final
	versions of the program under MOTIF, since I do not have C++
	on the HPUX system I have access to).

4.	I  think  GCC 2.7.2 or later is manditory, largely because I
	believe this is required to compile and use LessTif.

5.	The  C++ libraries must support exception handling.  I don't
	know  what   version  this  started  to  work,  but  I  have
	successfully used this with libg++.so.27.1.4.


GETTING TO THE POINT; INSTALLATION:
-----------------------------------

RESOURCES INSTALLATION NOTE:

	While  this  application  uses  resources, you do NOT need to
	install a resource file for this application. I my view, this
	type  of utility should be wholy contained if possible as one
	simple to install unit, which it is here.

	However,  if  you do wish to customize its look and feel, you
	can of course install your own resource files. To get an idea
	of  what  the  widget  class  names are,  you can examine the
	fallback_resources[] array in the xltcdplay.cpp source file.

	Be  aware  that  the fallback resources used here are for the
	most part explicitly named.  This can have consequences about
	what  you  must  specify  in  your  command line options  and
	resource files.


1. Edit the Makefile to suit (optional):

	Parameters you may wish to change:

		INSTDIR=/usr/local/bin/

	Determines where the final executable gets installed.

		INSTALL=install

	This determines the install command name to use.

		CPU= -m486

	I  can't  imagine  running  LessTif on a 386, but if you do,
	then  you'll  need  to  change this.  Speed freaks that have
	Pentiums  and Pros, may get  further gains by an appropriate
	adjustment here.

		CPOPTS=	-c $(DEBUG)$(OPT) $(CPU) -fhandle-exceptions

	If you do not have /dev/cdrom set up, or you prefer to name
	it something else, then add the option:

		-DCDROM_PATHNAME=/dev/my_device_name

	to the CCOPTS= line in the makefile.

2. $ make clean

	This  deletes  pesky  temp.  files  etc.  from  a prior make
	attempt if your first attempt(s) failed.

3. $ make

	This should build the executable xltcdplay.  Its size should
	be a nice small size of about 62k bytes.  About 42k bytes if
	you strip the executable.

3. $ su root

	If you're not root yet.

4. $ make install

	To test, type xltcdplay from an xterm session.

5. To properly install it in your fvwm2 for example, you may want to
add   a  button   to  your  /usr/X11R6/lib/X11/fvwm2/.fvwm2rc  file,
something like:

	*FvwmButtons CD NULL Exec "XLTCDPlay" xltcdplay

(for full X Window manager installation (fvwm2 or otherwise), please
be  referred to  your  Window manager  documentation  --  the  above
example  is  by no means, a full discourse on Window manager startup
scripts).

6. Read the file README.VOLUME. Its important.
