The following applies to usesrs who wish to use my set of tools to process
Cadabra notebooks on Linux.

0. REQUIREMENTS
---------------

1. Some flavour of Linux
2. GPC GNU Pascal complier (see note 3 below)
3. xpdf (or KPDF, Envince etc.) to display pdf output
4. A patched version of Cadabra to allow % as a comment marker (see note 5 below).

1. USAGE
---------

1. Create a cadabra source document (eg. sample.cdbp) using your favourite editor.

2. At a command line type "cdbmerge sample"

	A pdf preview window should pop up displaying the formatted Cadabra output.
	
2. INSTALLATION
----------------

1. Extract the contents of the archive,

		gunzip lcb-linux-cdb.tar.gz
		tar xf lcb-linux-cdb.tar
		cd lcb-linux-cdb
			
2. Copy the cadabra LaTeX class file to a place where TeX can find it, for example

		cp tex/* ~/tex/inputs/cadabra/.
			
3. Copy the shell scripts to somewhere on your path, for example

		cp sh/* ~/local/sh/.
		
4. Compile the pascal programs.

		cd src; make; cd ..
		
		note: this will create a new directory ~/pascal/units/
		
5. Copy the binaries to somewhere on your path, for example

		cp bin/* ~/local/bin/.		
		
3. NOTES
---------

1. The scripts do not properly process some Cababra commands, in particular
   @tree.

2. Don't use ; after any of the declaration statements, for example don't write
   @reset; Doing so will confuse the cdbmerge program and your output will not
   appear in the correct place.

3. Linux binaries for GPC pascal compiler for can be found here
   http://www.gnu-pascal.de/contrib/chief/
   It's best to get the "...with-gcc..." versions of the binaries (these contain a
   customised gcc that is stored separately from the system gcc, the system gcc
   is un-affected by this customised gcc).

4. Linux sources for GPC pascal compiler can be found here
	http://users.monash.edu.au/~leo/software/pascal/index.html
	You'll need both the GPC and GCC sources. The compliation instruction can be found
	in section 4.3 (page 28) of the GPC manual (also at the above web site).
	The instructions are very clear and easy to follow. It should take no more than about
	10-15 minutes.
	
5. The patch file for Cadabra-1.06 can be found in cadabra/patch/1.06. You will need to apply
	this to the sources and re-compile cadabra.
	
---------------------------------------------------------------------------------------------
Leo Brewin
School of Mathematical Sciences
Monash University
Australia
http://users.monash.edu.au/~leo
