


===============================================================================
---------------------------- cd_create v0.3 README ----------------------------
===============================================================================

This version was released on June 13, 2005.

More documentation regarding this software can be found on:

http://cdcreate.dev.java.net/
http://abi.e-arroyo.net/projects/edc/

Bugs and comments can be reported at:

http://abi.e-arroyo.net/contact.html

All files included with this package are licensed under the GNU 
Public License. For details regarding the license, please read gpl.txt,
which is included with this package.



------------------
Quick start guide:
------------------



Here are the files that need to be run or edited:

 
            .----------------------------------------------.
            |       Windows        |       UNIX            |
.--------------------------------------------------------- |
|           |                      |       edit            |
|           |  edit env_setup.bat  |  build_cd_create.sh   |
|           |                      |   run_cd_create.sh    |
|   Setup   |----------------------------------------------|
|           |                                              |
|           |                  code/.edcrc                 |
|           |                                              |
|--------------------------------------------------------- |
|           |                      |                       |
|    Run    |  run_cd_create.bat   |  build_cd_create.sh   |
|           |                      |                       |
|--------------------------------------------------------- |
|           |                      |                       |
|   Build   |  build_cd_create.bat |   run_cd_create.sh    |
|           |                      |                       |
'----------------------------------------------------------'

Edit the files in the "Setup" Catagory before running or building
cd_create. The files need to be modified for settings that vary
from system to system. 



----------------------
Prerequisite Software:
----------------------



	* Java:       http://java.sun.com/downloads/index.html
	* cdrtools:   http://freshmeat.net/projects/cdrecord/
	* md5deep:    http://md5deep.sourceforge.net/



------------------
Running cd_create:
------------------



cd_create is a Java program that will allow users in Windows and UNIX
environments to easily burn CD/DVD media. 

To run create you will need at least Java JRE version 1.4.2. To check if it
is installed and properly setup, please type the following  at your command
prompt: 

     java -version

The output of the command must be at least:

     java version "1.4.2_04"
     Java(TM) 2 Runtime Environment, Standard Edition (build 1.4.2_04-b05)
     Java HotSpot(TM) Client VM (build 1.4.2_04-b05, mixed mode)

Other older versions might work without a problem, but I have not tested
them myself.

If you have a Java JRE installed, but when you type the command above you get
an error you need to ensure that the JRE is in your PATH variable. 

In UNIX this can be done by typing <echo $PATH> and on Windows by typing
<echo %PATH%> on the command line.

Once you have verified that your environment is properly setup, please run
the appropriate shell script below:

     UNIX:                  run_cd_create.sh
     Microsoft Windows:     run_cd_create.bat

If does not work you may have accidentally deleted the binary files
included with the package by running the the build script. To get the
binary files back simply unpack the download again, or read the building
section below.

The last setup issue is ensuring cd_create can locate cdrecord, mkisofs,
and md5deep. The location of these programs can be set by editing the
configuration file <code/.edcrc>.




---------------------
Compiling the source:
---------------------



In the package both the binary and source code files are included. To compile
the code you first need to have the Java SDK installed.

You can test whether you have the Java SDK installed by typing "javac" at the
command line. The output shoud look similar to a help menu, and should not
say command not found.

Once you've got the Java compiler installed the next step is to edit the build
script. The build scripts must be able to locate the Java Compiler.

     UNIX:                  build_cd_create.sh
     Microsoft Windows:     env_setup.bat

Once that is complete, execute the build script followed by the run script.




-----
FAQs:
-----



Q. I terminated the application early, and now I'm getting an error when 
checksums are being created.

A: When the verify.bat script file is run and it is then cancelled, sometimes
Windows does not properly terminate <md5deep.exe>. Type Cntl+Alt+Del and
terminate the runaway md5deep process.


Q. I don't like typing "Control+Z and then Enter" when I exit. How can I 
stop this?

A: Remove the last five lines of <env_setup.bat>. The last five lines are:

echo.
echo.
echo Press Control+Z, then enter to exit...
copy con cd_create.test
del /q cd_create.test

Save the file after the lines have been removed, and you will no longer
receive those messages.  


Q. Why do I keep running into errors?

A. Make sure the CD is already in the drive when you start the application.
It will not prompt you to enter a CD.