The Cintcode BCPL System

This README file lives in the home directory of the BCPL 
cintcode system (often with a name like ---/BCPL/cintcode).

The most important files in this directory are:

README          This README file.

Makefile        To recompile the C and assembly language
                components of the system, link them and
                then enter the system. This version is
                initially for Linux. Makefiles for other
                architectures can be constructed by means
                of minor edits to this file.

cinterp         The compiled form of the system.

cinterp.exe     The compiled form of the system for Windows 95/98/NT

rasterp         A version of the the system capable of
                generating a postscript version of a time
                memory address diagram of the execution of
                a program. It creates the file RASTER.ps.

SYSLIB, BOOT, BLIB and CLI
                Cintcode modules loaded during system 
                initialisation.

libhdr          The standard header file.

IOHDR, CLIHDR   Other header files.

bc, bs          Command command files for compilation of
                BCPL programs in ../cintcode/com and 
                ../cintcode/sys.
                Typical usage:  c bc echo
                                c bs BLIB

b               A command command file for compilation of
                user BCPL programs. Typical usage: 

                     cd ../bcplprogs/demos
                     cinterp
                     c b queens
                     queens

bco, bso        Command commands for compilation of modules
                for "other ender" machines.

OENDER          A directory containing Cintcode compilations
                of the vital parts of the system for
                "other ender" machines.

compall         A command command to recompile all the BCPL
                files constituting the cintcode system.

doc             A directory containing documentation files,
                such as doc/README and doc/notes.

sys/cinterp.h   Header file containing system/architecture
                dependent #defines.

sys/cintmain.c, sys/cinterp.c, sys/kblib.c and sys/nullrastlib.c
                The C components of the system.

sys/cintasm.s   An assembly language program equivalent to
                sys/cinterp.c.

sys/rasterp.c sys/rastlib.c
                Modules used by the raster generating version of
                the system.

sys/BOOT.b, sys/BLIB.b and sys/CLI.b
                The BCPL source of BOOT, BLIB and CLI.
                (SYSLIB is hand written).

sys/SYSLIB      Hand written Cintcode for the library functions:
                sys, chngeco and muldiv.

sys/
                This contains the directories ALPHA, MIPS, SUN4,
                SPARC, MSDOS, MAC, OS2, ARM, BC4, CYGWIN32,
                Win32 and shWinCE. These containing architecture
                dependent files and (with luck) corresponding
                README files.

../bcplprogs    A directory containing directories of 
                demonstration BCPL programs.


Martin Richards                               27 January 2000

