Gardens Point Component Pascal Compiler. (.NET)
---------------------------------------------
Instructions for compiling the various demo programs.
0. General Instructions:
----------------------------
a) The compiler must be on your PATH, probably 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
c) In order for programs to run you will need to have access to any DLLs that
	are referenced.  These are NOT found from the PATH, unless the
	executable has been found on the path.  You should copy RTS.dll
	into this working directory, if it not already there.
	copy \gpcp\libs\dll\RTS.dll .

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

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

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

3. Hennessy.
--------------
a) compile with
	gpcp Hennessy.cp
b) execute with
	Hennessy
c) These are the Hennessy integer benchmarks.  These might improve slightly
	for later versions, but they are pretty close to native speeds already.

3. MkOver.
--------------
This program tests the hash table overflow detection. You will need to have 
RTS.dll, GPText.dll, GPFiles.dll, GPTextFiles.dll copied into this directory
from the gpcp\bin directory.

a) compile with
	gpcp MkOver.cp
   this creates the executable MkOver.exe. 
b) run MkOver with
	MkOver
   When you run MkOver.exe it will create a file TooBig.cp which has 5000 
   separate constants defined.  
c) try to compile TooBig.cp
	gpcp TooBig.cp
   This should trap with a hash table overflow. 
d) Retry compiling with
	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 ------------------------------------------

