
Mac OS X instructions:
----------------------

X-CD-Roast 0.98alpha15 fully supports Mac OS X.2 (Jaguar).

NOTE: This release might not work correctly on OS X.3 (Panther). I will
      provide patches and a new package when I have a Pather system setup.
 
But as it is not a native application, but a port from classic unix
systems there are some things which need to taken care of.

First of all you need an X-Server and the development packages to compile
X-CD-Roast. You also need to install the GTK library set.  

The X-Server is the display engine which understands the X11 protocol. 
I recommend that you install the provided package from Apple:

	http://www.apple.com/macosx/x11

GTK is the drawing interface which X-CD-Roast uses to create buttons and
entry fields and all the graphical representation. You can install all 
the required libraries via fink (http://fink.sourceforge.net).
See the main X-CD-Roast README file for more information about the sources.


If all libraries are installed you can simply run "./configure" and "make" 
build a binary of X-CD-Roast.

After a "make install" (you have to be root) you can start to use
X-CD-Roast. For DVD support please read the file README.ProDVD now.

Start up X11 and an xterm window will appear. Type 
	
	/usr/local/bin/xcdroast

to start X-CD-Roast. Follow then the on-screen instructions.

To use X-CD-Roast in a different language you have to manually
activate them. (Right now OS X does not support unix style 
language support.)

Here an example for German:

	when using bash:
		LANG=de_DE /usr/local/bin/xcdroast -o

	when using tcsh:
		setenv LANG de_DE; /usr/local/bin/xcdroast -o


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

There are some known issues yet:

- At startup you might this message:

	"Warning: locale not supported by C library":
	
  This is a incompatibilty of the locale stuff from apple. You have simply
  to ignore it. Due the same problem you can't switch your language from
  the Setup-Menu. However, when you set the the LANG environment variable
  before starting X-CD-Roast, you can use other languages.
	
  See also: http://fink.sourceforge.net/doc/x11/trouble.php#locale 


- Only CD-Writers are supported.

  Due the nature of the OSX device interface only real CD-Writers can be
  used withing X-CD-Roast. DVD-Drives or normals CD-ROM-drives are 
  ignored. You cannot even use these to read data only.


- Finder grabs all CDs.

  The finder tends to automount all CDs you insert. Then they are lost
  from being accessable from within X-CD-Roast. Currently the only known
  solution is to stop the "autodiskmount" daemon. 

  New in version 0.98alpha14 is support for automatic handling of the
  daemon. You just choose the option to disable the daemon at startup and
  X-CD-Roast will handle that.

  Here is the procedure if you want to know what X-CD-Roast is doing:

     X-CD-Roast stops the daemon like this:

	ps -ax |fgrep autodiskmount

	  	(The first number in that output is the pid)

	sudo kill -STOP <pid>

    After you are done with X-CD-Roast it is started again:

	sudo kill -CONT <pid>

  Note: While the autodiskmount daemon is stopped you might not be able to 
	eject media with the keyboard. Just use the eject feature from 
	X-CD-Roast.


- Created Data-CDs are Unix/Windows-CDs.

  X-CD-Roast does currently not support the writing of HFS CDs. This means
  you can only files that have no resource component (like .dmg, .sit, 
  all types of files you can download from the internet).

---

27.10.2003 Thomas Niederreiter (tn@xcdroast.org)

