Gardens Point Component Pascal Compiler. (JVM on Microsoft)
---------------------------------------------
Instructions for compiling the various demo programs.
0. General Instructions:
----------------------------
a) The batch files cprun.bat and cpint.bat must be on your PATH, probably in
	C:\gpcp\bin
b) The compiler must be able to find the library symbol files, probably by
   using the env. variable CPSYM. Typically
	set CPSYM=.;C:\gpcp\libs

0. Hello.
---------------
a) compile with
	cprun gpcp Hello.cp, or even cprun gpcp -verbose Hello.cp
b) execute with
	cprun Hello

1. HelloWorld.
---------------
a) compile with
	cprun gpcp HelloWorld.cp, or even cprun gpcp -verbose HelloWorld.cp
b) execute with
	cprun HelloWorld
c) now try
	cprun HelloWorld more command line args

2. NQueens.
------------
a) compile with
	cprun gpcp NQueens.cp
b) execute with
	cprun NQueens
c) now you know how many solutions there are to the NQueens problem for the
	various board sizes!

3. Hennessy.
--------------
a) compile with
	cprun gpcp Hennessy.cp
b) execute with
	cprun Hennessy
c) These are the Hennessy integer benchmarks.  These might improve slightly
   for later versions, but they are pretty close to native speeds already.
   If you want to know how much slower the interpreter is, use
	cpint Hennessy
   which sets java.compiler=NONE

3. MkOver.
--------------
This program tests the hash table overflow detection
a) compile with
	cprun gpcp MkOver.cp
   this creates the executable CP\MkOver\MkOver.class
b) run MkOver with
	cprun MkOver
   When you run MkOver it will create a file TooBig.cp which has 5000 
   separate constants defined.  
c) try to compile TooBig.cp
	cprun gpcp TooBig.cp
   This should trap with a hash table overflow. 
d) Retry compiling with
	cprun gpcp -hSize=6000 TooBig.cp
   All is now ok!

You may browse the code of MkOver.cp to get a simple example of creating
and writing to text files.

--------------------------- Have Fun ------------------------------------------

