-----------------------------------------------------------
|                                                         |
|              X-CD-Roast 0.98alpha15                     |
|                                                         |
|            30.10.2003 T. Niederreiter                   |
|                                                         |
-----------------------------------------------------------


This is only a maintainance release, therefore no real new 
features yet.  

Whats new:
	
	- optional GTK2 support, thanks to Fritz Ganter for his help.
	- updated lot of translations, added romanian, latvian and
	  albanian.
	- numerous bug fixes.
	- included a contrib-directory with the sources with some
	  useful stuff sent to me by X-CD-Roast users.


See the file ChangeLog for a complete list of changes.

A recent release of the cdrtools is required. 
Version 2.0 or newer is recommended. 2.01a14 or newer for 
audio-on-the-fly support.

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 28 languages
- Graphical setup
- Graphical wav-player 
- Fully themeable via GTK-Themes
- Tooltip help 
- Copies Data, Audio, Mixed-Modes
- Creates Data, Audio, Mixed-Mode, Multisession 
- Bootable CD support
- CD-Text
- CDDB-support via HTTP/Proxy or native 
- Copy/Master Data and Audio-CDs on the fly
- Administration mode for usage in computer pools 
- Data-DVD writing (DVD-R/RW, DVD+R/RW) - experimental DVD-Video support 
- Drag&Drop
- Networked device support (Remote-SCSI)

Features planned for the next releases:

- MP3/OGG encoding/decoding
- Clone-Mode
- ISO-file browser
- mkisofs HFS support


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)

   or alternatively GTK+-2.2.x 
   (compile with --enable-gtk2 in that case)

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)
   (not required for GTK2)

 - cdrtools-2.0 (or newer)
   (which includes cdrecord, mkisofs, cdda2wav, readcd)
	(ftp://ftp.berlios.de/pub/cdrecord/cdrtools-2.00.3.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.98alpha15.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
	--enable-gtk2			compile for GTK2 instead for old GTK
   )

   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.00.3.tar.gz 
	cd cdrtools-2.00.3
	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).

 - If you had the non-root mode from an older version of X-CD-Roast 
   activated you should reset the permissions on the cdrtools now.
   It's not longer required to have and suid-bits or special groups on
   these.

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 97% 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.


30.10.2003 Thomas Niederreiter (tn@xcdroast.org)
 
