Preliminarily manual for X-CD-Roast 0.98 alpha9
-----------------------------------------------

*** Please see the file "FAQ" for further information. ***

For this snapshot I am writing only the pure basics
about X-CD-Roast-test usage here.

I put a lot of effort in making this release "fool-proof".
After you installed and started X-CD-Roast (see README)
you are prompted to enter the setup-menu.

All buttons and controls provide tooltip (bubble) help, when you
rest the mousepointer more than 2 seconds above it. This should
help you in most cases. Options greyed out are currently not
implemented. These will come in future snapshots. 

Please note that there is NO build-in atapi-device support as there
was in earlier releases. So none of your atapi-devices will be
detected by xcdroast. (This never really worked anyway - so I removed
this feature - and it was also not portable.)
But you can use your atapi-writers/cdrom when you install scsi-emulation
for them. You need that anyway to write with cdrecord. See your favorite
cdrecord docs how to do that.
 
In setup you have to specify at least one image-directory. And this is also 
the biggest change from the setup of the old versions. 
There are no longer any image-partitions - please format your
partitions if you had any and mount them somewhere.
Pick all directories you want to store images in and put them 
in the image-partition-list in the HD-Setup. You can only 
add exactly one directory on each physical partition on your drive.
(This makes it much easier to calculate the available disk space.)

When you have more than one image-directory you can tell X-CD-Roast
to add all the space in them to store much more data as possible with
only one directory. X-CD-Roast will distribute all read tracks 
automatically to the available directory in case it would run out
of space otherwise. However, it won't break up big images - so a
600 MB image cannot stored when you have 400 MB free in one directory and
500 MB free in the other. You will get a "disk full"-warning when you try
to start to read the track. On the other hand an audio-disk with 10 tracks
needing about 70 MB disk space each can stored easily. The first 5 tracks 
would fit it the first directory and the other 5 in the second. 

Sounds complicated, but it actually very easy and quite a nice feature.

You may now wonder how you know where the track have been stored. 
The answer is simple - you dont have to know. X-CD-Roast keeps track
of that. For each CD read, X-CD-Roast will create a .toc-file 
(Table-Of-Contents) which has stored which tracks belong to which CD and
where exactly all fitting tracks are saved.

So when you want to burn your CD you just have to pick the .toc-file and
X-CD-Roast handles the details.   

When you delete the tracks after writing you simply can double-click
on the .toc-file and all the tracks belonging to that CD will be automatically
selected. Therefore its easy to keep track even when you stored lots of
CDs in your image-directories. You have always only exactly one file
to watch: The .toc-file.


One more thing: You can double-click on any of the devices in the
device-scan-screen in setup to get a detailed output of the device
properties. (Gives for a MMC-writer a real informative output).

New in alpha3 is that you can read selected tracks from your CDs and
reorder them in any way you want before you burn them. 

Alpha4 does only contains several bugfixes, dynamic resize of the
menues when a bigger font is used and a rework of the language handling
to make translations easier.

In the alpha5 I included the master option. You can now create your own
data CDs. You can add as many directories to the image as you want. 
Use the "redirect" feature to place the directories on selected paths
on the CD. See the mkisofs-manpage under "graft pointers". 
Its also now possible to create an image "on-the-fly", so you don't need
any free space on your hard drive. Just be sure to have a fast enough
computer to avoid buffer-underruns. 
All this is very experimental and hardly tested at all!

Alpha6 was a maintainance release. No real new features, but tons of
fixed details. Its a lot stabler than the alpha5.

Alpha7 adds the non-root-mode. You are now able to start X-CD-Roast as
every user, provided root installed it correctly and gave you permissions.
Also some bug-fixes - should now really be quite robust.

Alpha8 is a security update - alpha7 has some problems with the permissions.
There are also a handful bugfixes and improvements.

Alpha9 comes with a completely reworked non-root-mode and requires
cdrecord-1.10 as cdwriting engine. There are tons of bugs fixed and 
some changes to the master menues.

Ok...this is all you need to know to copy or create your CDs. 
Please be sure to check the "README" and "FAQ"-file first before mailing me
any questions. 

This is only a test-release and I don't know when the final version
is done or a new test will come out. Look on my page for updates - 
the next alpha version (with multisession support) should be out soon.

17.07.2001 Thomas Niederreiter <tn@xcdroast.org>