This is a kit for bringing up a BCPL compiler on any machine that has a
C compiler.  It is the INTCODE compiler kit written by Martin Richards,
the inventor of BCPL.

Briefly the steps are:

1. Write an interpreter for INTCODE. This has been done for you in C.
As far as I know it runs on Unix (BSD flavour), MSDOS (using the Cware
compiler) and CP/M (using the C80) compiler. There are also tuned
assembly code versions of the interpreter for MSDOS and CP/M.
Executables for MSDOS and CP/M are also provided.

2. Ensure that it runs properly by running it on some INTCODE programs
like fact.int (factorial) or cgtest.int (code generator tester).

3. The bootstrap: This step is optional because you can keep on using
the INTCODE versions of the compiler, but if you want to make any
compiler modifications you have to pass this step.  Using the INTCODE
versions of the BCPL compiler passes: s.int (SYN), and c.int (CG, OCODE
to INTCODE backend), recompile the BCPL source (syn.bpl, trn.bpl and
cg.bpl) of the compiler passes.  Yes, bootstrapping is a
self-referential process. Note that the compiler will expect filenames
in uppercase, hence the uppercase name links to the header files
(*hdr.bpl). The file OPTIONS contains flags that control the behaviour
of the passes. The option L7500 is required for the compiler to
compiler itself. Then you will have to concatenate the INTCODE library
stubs (icint.int) and utility routines (blib.int) to make an INTCODE
"executable".  The sources of the utility routines are in blib.bpl.
The shell script "bcpl" automates these steps for making an INTCODE
executable from BCPL source file.

4. You now can compile BCPL programs to your heart's content.  If
you're really ambitious, you can write a code generator from OCODE to
assembly code.

The program icint has some option flags. In brief:

	-pn	sets the max program area size to n
	-gn	sets the max global area size to n
	-s	store a compact version of intcode in second file arg
	-l	load a compact version of intcode from first file arg
	-u	complain about unset globals
	-v	verbose, more messages

 PERMSSN    UID  GID    PACKED    SIZE  RATIO     CRC       STAMP          NAME
---------- ----------- ------- ------- ------ ---------- ------------ -------------
[generic]                  546     909  60.1% -lh5- 7bda Oct 22  1991 bcpl.txt
[generic]                  241     448  53.8% -lh5- 3c47 Jan 25  1991 bcpl/bcpl
[generic]                  210     287  73.2% -lh5- f33d Jan 22  1997 bcpl/bcpl.rexx
[generic]                 1138    2818  40.4% -lh5- 5d86 Mar 24  1988 bcpl/blib.bpl
[generic]                 1016    2539  40.0% -lh5- 263e Mar 24  1988 bcpl/blib.int
[generic]                 6955   18694  37.2% -lh5- 91d1 Mar 23  1988 bcpl/booting.doc
[generic]                 5501   16618  33.1% -lh5- 377b Mar 24  1988 bcpl/c.int
[generic]                 3515   14655  24.0% -lh5- 10f4 Mar 24  1988 bcpl/cg.bpl
[generic]                 4337   13637  31.8% -lh5- ae20 Mar 24  1988 bcpl/cg.int
[generic]                 2492    5355  46.5% -lh5- b523 Mar 24  1988 bcpl/CGHDR
[generic]                 2492    5355  46.5% -lh5- b523 Mar 24  1988 bcpl/cghdr.bpl
[generic]                 2141    6893  31.1% -lh5- 5b4c Mar 30  1988 bcpl/cgtest.bpl
[generic]                 3828   12152  31.5% -lh5- 7e11 Jan 25  1991 bcpl/cgtest.int
[generic]                  113     150  75.3% -lh5- a17b Mar 24  1988 bcpl/fact.bpl
[generic]                 1416    3309  42.8% -lh5- 41ae Jan 25  1991 bcpl/fact.int
[generic]                11264   19708  57.2% -lh5- e557 Jan 18  1997 bcpl/icint
[generic]                 3390   10601  32.0% -lh5- 212b Jan 22  1997 bcpl/icint.bpl
[generic]                 2899    8636  33.6% -lh5- bd8d Feb  3  1991 bcpl/icint.c
[generic]                 7387   13696  53.9% -lh5- f275 Oct 10  1991 bcpl/icint.com
[generic]                 7357   21789  33.8% -lh5- a23f Mar 23  1988 bcpl/icint.doc
[generic]                 8476   15872  53.4% -lh5- ecdc Feb  4  1991 bcpl/icint.exe
[generic]                  808    2047  39.5% -lh5- 804b Feb  3  1991 bcpl/icint.h
[generic]                  226     442  51.1% -lh5- 58f3 Mar 24  1988 bcpl/iclib.int
[generic]                 2590    9322  27.8% -lh5- 4c6b Feb  1  1991 bcpl/interp.asm
[generic]                 1263    3760  33.6% -lh5- 9db6 Feb  5  1991 bcpl/interp.c
[generic]                 1539    4657  33.0% -lh5- 57d8 Feb  4  1991 bcpl/interp.cware.c
[generic]                  816    1539  53.0% -lh5- a4c0 Mar 23  1988 bcpl/LIBHDR
[generic]                  101     180  56.1% -lh5- a319 Feb  6  1991 bcpl/Makefile
[generic]                    6       6 100.0% -lh0- 0c60 Jan 29  1991 bcpl/OPTIONS
[generic]                 1020    2095  48.7% -lh5- bfde Oct 10  1991 bcpl/README
[generic]                15409   49538  31.1% -lh5- 6417 Mar 24  1988 bcpl/s.int
[generic]                  173     284  60.9% -lh5- 663d Jan 22  1997 bcpl/SMakefile
[generic]                  956    3261  29.3% -lh5- dd92 Feb  3  1991 bcpl/sub.c
[generic]                 6584   28695  22.9% -lh5- c904 Jan 25  1991 bcpl/syn.bpl
[generic]                 8004   25190  31.8% -lh5- b193 Jan 25  1991 bcpl/syn.int
[generic]                  961    1924  49.9% -lh5- f7ec Jan 25  1991 bcpl/SYNHDR
[generic]                  961    1924  49.9% -lh5- f7ec Jan 25  1991 bcpl/synhdr.bpl
[generic]                 5007   23648  21.2% -lh5- 2f18 Jan 25  1991 bcpl/trn.bpl
[generic]                 6441   21492  30.0% -lh5- a852 Jan 25  1991 bcpl/trn.int
[generic]                 1091    2215  49.3% -lh5- dc0a Jan 25  1991 bcpl/TRNHDR
[generic]                 1091    2215  49.3% -lh5- dc0a Jan 25  1991 bcpl/trnhdr.bpl
[generic]                   62      67  92.5% -lh5- 445c Jan 22  1997 changes
[generic]                 4811   11300  42.6% -lh5- 99a8 Dec  6  1988 tripos/bcpl.doc
[generic]                 1421    4809  29.5% -lh5- b350 Dec  6  1988 tripos/bcpl.h
[generic]                  894    1916  46.7% -lh5- 8a67 Dec  6  1988 tripos/bcpllib.c
[generic]                  752    1539  48.9% -lh5- 1294 Dec  6  1988 tripos/hello.c
[generic]                  909    2228  40.8% -lh5- a4d9 Dec  6  1988 tripos/myendcli.c
[generic]                 2836    8842  32.1% -lh5- a8f2 Dec  6  1988 tripos/mynewcli.c
[generic]                 2794    8288  33.7% -lh5- bebf Dec  6  1988 tripos/myrun.c
[generic]                 1423    3029  47.0% -lh5- 168a Dec  6  1988 tripos/process.doc
[generic]                 3710    9996  37.1% -lh5- bd79 Dec  6  1988 tripos/ramlib.doc
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total        51 files  151373  430569  35.2%            Jan 24  1997