###########################################################
#                                                         #
#              X-CD-Roast 0.98alpha12                     #
#                                                         #
#            22.12.2002 T. Niederreiter                   #
#                                                         #
###########################################################


This is mainly a bugfix release, but I also introduce some
new experimental code. Most visible change is the direct 
support of the ATAPI interface on linux 2.4.x kernels. 
SCSI-emulation is optional now - please see the FAQ for 
details about this issue.

The ProDVD support code is completely rewritten and should
perform better now. Please see the README.ProDVD file.

Now there is also proxy-authentication support for CDDB lookups.

The README.MacOSX file got rewritten too and contains detailed
information on how to get X-CD-Roast running fine on this platform.

The manpage includes now information on how to run more than one
instance of X-CD-Roast at the same time. (Using multiple writers)


A very new release of the cdrtools is required. Minimum release is
1.11a34, 2.0pre or newer is recommended.

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:

- Portable - runs on Linux, FreeBSD, OpenBSD, Solaris, HPUX, Irix, AIX ...
- Multi langual - translations available in 26 languages
- CDDB-support via HTTP/Proxy or native 
- Graphical setup
- Graphical wav-player 
- Tooltip help 
- Copies Data, Audio, Mixed-Modes
- Creates Data, Audio, Mixed-Mode, Multisession 
- Bootable CD support
- Copy/Master Data-CDs on the fly
- Administration mode for usage in computer pools 
- Data-DVD writing - experimental DVD-Video support 

Features planned for the next releases:

- MP3/OGG encoding/decoding
- Clone-Mode
- ISO-file browser


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.11a40
	  (or newer).
	 	
	  SuSE-Users please note: X-CD-Roast requires the gdk-pixbuf
	  library which is not installed by default on many SuSE-
	  installations. Just insert your CDs and install it using YaST.
 
	  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)
        (GTK2 is not yet supported)

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  
	(http://www.ibiblio.org/pub/Linux/libs/graphics/libungif-4.1.0.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.15.tar.gz)

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

 - cdrtools-1.11a34 (or newer)
   (which includes cdrecord, mkisofs, cdda2wav, readcd)
	(ftp://ftp.berlios.de/pub/cdrecord/alpha/cdrtools-2.0pre3.tar.gz)



Installation:

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

 - Take care to REMOVE first old installations of X-CD-Roast first, especially
   if these were installed from RPMs. Having two releases of X-CD-Roast 
   confuses most users.
   
 - Unpack xcdroast-0.98alpha12.tar.gz and run 

	./configure

   To install xcdroast in another prefix-path than "/usr/local":

	./configure --prefix=/usr

   You can also configure where X-CD-Roast should look for the cdrtools.
   By default X-CD-Roast first looks in $PREFIX/lib/xcdroast-0.98/bin and
   then in $PREFIX/bin. 
   Example:

	./configure --prefix=/usr --with-cdrtools-prefix=/opt/schily


   See "./configure --help" for a full list of supported options.
   (Useful ones might be too:
		
	--mandir=DIR			(Where the man page will be installed)
	--sysconfdir=DIR		(Directory of the root-config file)
	--with-xcdroast-libdir-prefix=PFX  (default: PREFIX/lib/xcdroast-0.98)	
	--disable-nonrootmode           do not use X-CD-Roast non-root mode
   )

   Now compile X-CD-Roast with typing:

	make

   And install it with:

	make install

   (You might have be root to run this command)


 - Install cdrecord, mkisofs, cdda2wav and readcd: 

   See the cdrtools documentation about details.

   Example under Linux:

	tar xvfz cdrtools-2.0pre3.tar.gz 
	cd cdrtools-2.0
	make
	make INS_BASE=/usr/local install

   (If you dont set INS_BASE when doing "make install" the cdrtools will
    install themselves to /opt/schily.)

   X-CD-Roast looks for the cdrtools first in $PREFIX/lib/xcdroast-0.98/bin 
   ($PREFIX is /usr/local if you dont changed it) and if it does not find
   them it tries $PREFIX/bin (or whatever you configured as 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. 

 - 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:

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


22.12.2002 Thomas Niederreiter (tn@xcdroast.org)
 
