###########################################################
#                                                         #
#              X-CD-Roast 0.98alpha10                     #
#                                                         #
#            23.04.2002 T. Niederreiter                   #
#                                                         #
###########################################################


Alpha10 is the long awaited release that adds multi session,
CD-Text and experimental DVD support. The non-root mode is now 
also much easier to configure and there have been a lot of 
other improvements.

It does now require a very recent version of the alpha releases
of the cdrtools-1.11 to work. 

Please check the CHANGELOG file for details.

This release is very friendly to distribution-vendors. In the RPM
version there are no longer any suid/sgid-bits set or any groups
created. No need to disable non-root mode now before including 
X-CD-Roast to your distribution. The check for the cdrecord tools
also accepts now silently newer versions.

 
For news 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 (*)
- Data-DVD writing (*)
- 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.11alpha19
	  (or newer).
	 	
          This release also uses gdk-pixbuf instead of imlib. Please be
	  sure you have this installed. 
 
	  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 
	(http://www.libpng.org/pub/png/src/zlib-1.1.4.tar.gz)
	(http://www.libpng.org/pub/png/src/libpng-1.0.13.tar.gz)

 - gdk-pixbuf-0.8.0 (or newer, current version is 0.17.0)
	(ftp://ftp.gnome.org/pub/gnome/unstable/sources/gdk-pixbuf/gdk-pixbuf-0.17.0.tar.gz)

 - cdrtools-1.11a19 (or newer)
   (which includes cdrecord, mkisofs, cdda2wav, readcd)
	(ftp://ftp.fokus.gmd.de/pub/unix/cdrecord/alpha/cdrtools-1.11a21.tar.gz)



Installation:

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

 - Type "make" and hope xcdroast compiles cleanly. 
   To use another makefile you can also use e.g. "make -f Makefile.solaris".

   If you want to install xcdroast in another prefix-path than "/usr/local" 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 is 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/local", X-CD-Roast will also search in "/usr/local/bin" for the 
   cdrecord-tools, or in the prefix you gave with CDRTOOLS_PREFIX.)

   Don't make links to the cdrtools because then the activation of the 
   non-root-mode will fail. Please copy the binaries instead. 

   Example under Linux:

	tar xvfz cdrtools-1.11a21.tar.gz
	cd cdrtools-1.11
	make
	make INS_BASE=/usr/local 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")

   WARNING: This release will overwrite any old versions of X-CD-Roast.

 - To enable the non-root mode you just have to start X-CD-Roast now. 
   The instructions in "README.nonroot" are done automatically on 
   startup (if you choose so).

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 release shows only about 95% 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.


23.04.2002 Thomas Niederreiter (tn@xcdroast.org)
 
