INSTALLATION NOTES FOR CD-Rchive version 1.2.3
--------------------------------

Author :-     mickgr@drahthaar.clara.net


EDITING THE CONFIGURATION FILE (cdr.conf)
------------------------------

This is not necessary unless you wish to change 2 defaults.

The cdrchive configuration file, cdr.conf, can be usefully edited by 
the user in ONLY 2 FIELDS: 'TEMP='  and  'DOCS='
All other fields are overwriten by the contents of the corresponding 
line edit controls etc when CD-Rchive is closed.

CD-Rchive uses /tmp directory by default for temporary files used to
display output.  If you wish to change the temporary file directory 
or where CD-Rchive looks for the HTML documentation edit these with
the FULL path of the new directories.  The HTML docs are located
in ${datadir}/doc/cdrchive; ${datadir} corresponding to --datadir=
when running configure.

Open CD-Rchive and if the documentation displays all is well.


COMPILATION OF SOURCES
----------------------

This version of CD-Rchive uses the QT-2.x, libpng and X11 libraries.   
Configure will look for them, try running ./configure without
any library options, and if it fails, try the following:

Your environment should contain a string similar to:-
QTDIR=/usr/lib/qt or QTDIR=/opt/qt-2.3 etc
If it does not you may have to add it with "export QTDIR=/usr/lib/qt" 
or perhaps "setenv QTDIR /usr/local/qt2.3".  See your shells docs for 
details. 

Run './configure --help' and try using the library path options.

If QT-2.x (currently QT-2.3) libraries are not installed on your system,  
you will need to install them.  There is a port in the ports tree,
x11/qt2, and there is a binary package at your favorite OpenBSD mirror,
http://www.openbsd.org/ftp.html. 
These are the libraries upon which the new KDE-2 is based as well as 
all its' attendent applications, so you will probably want them soon
anyway.  You can obtain the library sources from the Troll Tech site, 
http://www.trolltech.com/.

Once libraries have been sorted out:-

Just cd to the top directory of the expanded archive containing 
'configure' and run the usual

./configure
make
make install


RUNNING CD-Rchive
-----------------

When first run, CD-Rchive will display hints in many of the fields.  
Edit these with your own details and press the [EXIT] button.

Run CD-Rchive again and you will find all these entries saved and now displayed


BUGFIXES & IMPROVEMENTS
-----------------------

03062001 mkisofs latest versions deprecated the -a switch which 
	corresponds to the 'include all files' checkbox on the Image tab  
	page.  This checkbox is now not automatically set, allowing old 
	and new versions of mkisofs to work. It remains a valid user
	selection for older verions of mkisofs.
	
09062001 Excludes were not being put into the commandline when testing 
	the size of an image on the Source tab page.  I had left myself 
	a commented reminder but missed it!  Now works correctly!
	
18062001 Source / Exclude / wav file listbox code changed to allow up to 
	26 entries in each.  Method of writing cdr.conf changed to 
	accomodate but remain backwardly compatible and automatically 
	convert existing entries to new format.
	All browse dialogs changed to QT standard QFileDialog.  
	Standardises appearence and redices binary size by 40k.

21062001 2 typos in Makefile.in and one of source files preventing auto 
	compilation fixed.

28062001 Generated Makefile now has uninstall section 'make uninstall'
	Just displays details of which files to delete.  Too risky 
	automatically deleting on someone elses system.

13072001 Thanks to Jacob Meuser's patches for OpenBSD, that platform is 
	now supported by CD-Rchive.  Patches deal with differences in 
	capabilities of versions of mkisofs and cdrecord available for 
	for OpenBSD, differences in file system structure, default shells
	etc, etc.  I have incorporated the areas dealt with by the patches 
	into a separate OpenBSD distribution, with amended sources. 
	The non-functional aspects have just been disabled, allowing for 
	the functionality to be introduced if/when developments in versions 
	of mkisofs & cdrecord ported for OpenBSD leads to Joliet files
	and Multi-Session recording etc. being supported.  If you have
	any questions with regards to the OpenBSD version of CD-Rchive
	please contact Jacob Meuser at <jakemsr@clipper.net>.

	A small bugfix in the main Linux branch of the project, discovered 
	whilst doing the above, and a minor change to warn regards using 
	deprecated mkisofs switches prompted a re-release so both Linux 
	and OpenBSD have a unified version number of cdrchive-1.2.3

20072001 Further work by Jacob Meuser <jakemsr@clipper.net> porting to OpenBSD.
	The version of mkisofs ported to OpenBSD does not support multiple source paths
	making CD-Rchive functionality rather limited.
	Using mkhybrid instead allows multiple source paths and also restores the use
	of Joliet file extensions which are not supported by the OpenBSD mkisofs.


HOPE YOU FIND CD-Rchive USEFULL!!
---------------------------------
