###########################################################
#                                                         #
#               X-CD-Roast 0.98alpha9                     #
#                                                         #
#            17.07.2001 T. Niederreiter                   #
#                                                         #
###########################################################

Alpha9 comes with a ton of bug fixes and a brand new
non-root-mode that will work fine with the current GTK
releases. There is some nice new stuff in the master-menu
(sorry, still no multisession) and AIX and OpenBSD users 
should be able to use X-CD-Roast too. Please note that you
require the cdrtools 1.10. Also check the CHANGELOG file 
for details.
 
This alpha-release is again under the GPL. I do explicitly 
allow distributions to include this piece of software.
(After they tested it thoroughly, of course)

For news about new tests and previews see

	http://www.xcdroast.org


Some features: (marked with "*" if already implemented and working)

- Portable (*)
- Multi langual (*)
- CDDB-support (*)
- Graphical setup (*)
- Graphical wav-player (*)
- Tooltip help (*)
- Copies Data (*), Audio (*), Mixed-Mode (*), Multisession, CD-Extra
- Creates Data (*), Audio (*), Mixed-Mode (*), Multisession, CD-Extra
- Bootable CD support (*)
- Copy (*)/Master (*) on the fly.
- Administration mode for usage in computer pools. (*)
- MP3 encoding/decoding.


System-Requirements:

BIG NOTE: On recent Linux-distributions ALL the following libraries are 
	  included! There is NO need to download that stuff and install 
	  yourself.  Do use the things that are on your Linux-CDs!
	  The only package you might need to get is cdrtools-1.10.
	  
	  Be sure to have the DEVELOPMENT versions of the libraries 
	  installed. (marked with -dev oder -devel on the RPMs filenames)
	  Otherwise you will fail to compile any program.
	  This is also true for the X-development libraries.  


glib-1.2.3 and gtk+-1.2.3 (or newer, current version is 1.2.10) 
	(ftp://ftp.gimp.org/pub/gtk/v1.2/glib-1.2.10.tar.gz)
	(ftp://ftp.gimp.org/pub/gtk/v1.2/gtk+-1.2.10.tar.gz)

NOTE about GTK on solaris:
	GTK must be installed in /lib or /usr/lib on solaris in order
	to work. A setting in LD_LIBRARY_PATH is ignored.

	
libgif or libungif  
	(ftp://prtr-13.ucsc.edu/pub/libungif/libungif-4.1.0b1.tar.gz)
libz/libpng 
	(ftp://ftp.uu.net/.vol/1/graphics/png/src/zlib-1.1.3.tar.gz)
	(ftp://ftp.uu.net/.vol/1/graphics/png/src/libpng-1.0.9.tar.gz)

imlib-1.8.x (or newer, current version is 1.9.10)
	(ftp://ftp.gnome.org/pub/GNOME/stable/sources/imlib/imlib-1.9.10.tar.gz)

cdrtools-1.10
(which includes cdrecord, mkisofs, cdda2wav, readcd)
	(ftp://ftp.fokus.gmd.de/pub/unix/cdrecord/cdrtools-1.10.tar.gz)

Note: A newer version cdrecord might work if you start X-CD-Roast
      always with the -n option. This is NOT recommended.
 


Installation:

 - Install glib, gtk, lib[un]gif, libz,libpng, imlib (in that order)...
   (if not already installed)

 - Type "make" and hope xcdroast compiles cleanly. 
   (tested on solaris-2.6 and linux-2.x)
   If you want to install xcdroast in another prefix-path as "/usr" you
   have to modify the Makefile or start make like this: 
	"make PREFIX=/usr" 
   (Don't forget the PREFIX-parameter for make deinstall and install too, if 
    you used it in the first place!)

   There is a new option CDRTOOLS_PREFIX which let you choose where 
   X-CD-Roast should look for cdrecord. Default is the same as PREFIX.
   (always specify prefixes without "/bin" parts - so /usr is correct,
    /usr/bin not.)

 - If you had a prior alpha-version of X-CD-Roast 0.98 installed, you should
   now remove its files with "make deinstall" before continuing.
 
 - Install cdrecord, mkisofs, cdda2wav and readcd: 
   Compile the tools and copy the binaries to "lib/bin" of the xcdroast-source
   directory. Alternatively you can use "$PREFIX/bin" (if your prefix was
   "/usr", X-CD-Roast will also search in "/usr/local/bin" for the 
   cdrecord-tools, or in the prefix you gave with CDRTOOLS_PREFIX.)
 

   Example under Linux:

	tar xvfz cdrtoos-1.10.tar.gz
	cd cdrtools-1.10
	make		
	make INS_BASE=/usr install


 - Then you can do a "make install" in the X-CD-Roast source tree. 
   (you have to be root for this - again, dont forget the PREFIX if
    you used it before - like "make PREFIX=/usr install")

   (Alternatively you can run xcdroast in the current directory by
    starting "./xcdroast -l lib" without installing it)

   WARNING: This release will overwrite any old versions of X-CD-Roast.
	    So rename your old xcdroast binary if you want to keep it.

 - Before you can start X-CD-Roast now, you have to follow the
   instructions in "README.nonroot". This tells you how to
   set the permissions to let also a non-root user use X-CD-Roast.
   If you don´t want to let non-root users run X-CD-Roast, please 
   also consult the README - there are instructions for you.

Now you can start X-CD-Roast with "xcdroast". 



See DOCUMENTATION about basic usage and FAQ for any questions you may have.
 

Feedback/Bugreports:

If you think you found a bug (please don't write about "missing" features - 
remember this test shows only about 92% of the final product) you have
first to find out if you can reproduce it reliably. Then run xcdroast in
debug mode (-d 10 switch) and send me the output. Please describe
what exactly you have done and what went wrong. Also make your tests
with english or german texts! Otherwise I can't read the error-messages
myself!

 
Please note:

This code is alpha and it may screw up your scsi-bus, erase all your
disks and causes headaches. You have been warned. 

I won't answer any mails about things explained in this file or on
my webpage. 

The FAQ on http://www.xcdroast.org is the first place to look when
you have problems.


17.07.2001 Thomas Niederreiter (tn@xcdroast.org)