BCPL64 CINTCODE DISTRIBUTION (Revised 3 October 2006)



************************ IMPORTANT **********************************

   Before installing BCPL64, read this README file and remember
   to edit the Makefile and set the environment variable BCPL64ROOT to
   your chosen absolute location for the cintcode directory, and
   include this in the PATH environment variable.

   On my system (using bash under Linux), this is done by:

   export BCPL64ROOT=/home/mr10/distribution/BCPL64/cintcode
   export PATH=$PATH:$BCPLROOT

   (The variables BCPL64PATH and BCPL64HDRS no longer need to be set.)

*********************************************************************

You must install the 32-bit version of BCPL (BCPL.tgz or BCPL.zip)
before installing the 64-bit version.


A manual for Cintcode BCPL and Cintpos is available via my home page.


LINUX INSTALLATION 

This section describes how to install Cintcode BCPL64 on an IBM PC
running Linux.

1) Choose a directory into which you wish to install BCPL64 and copy bcpl64.tgz
into it. E.g:

        cd <somewhere>          -- eg: cd $(HOME)/distribution
        cp <bcpl64.tgz> .
        ls -l

2) Extract the files for the BCPL64 system, eg

        tar zxvf bcpl64.tgz

Some browsers will have already automatically decompressed bcpl64.tgz,
so you may have to use the following command instead:

        tar xvf bcpl64.tgz

This will create the directories BCPL64, BCPL64/cintcode and
BCPL64/bcplprogs fill them with useful material. The directory
BCPL64/bcplprogs contains subdirectories of demonstration programs.

3) In order to use the BCPL64 Cintcode system from another directory
define the shell variables BCPL64ROOT, BCPL64PATH and BCPL64HDRS must be
given the absolute file names of the BCPL64 root directory, the
directory containing the compiles commands and the directory
containing the BCPL64 header files. The BCPL64ROOT directory should also
be added to your PATH.  This can be done by editing the file
BCPL64/cintcode/setbcpl64env, if necessary, and running the command:

        . setbcpl64env          under bash
or
        source setbcpl64env     under the C-shell

This will execute commands similar to:

        export BCPL64ROOT=$HOME/distribution/BCPL64/cintcode
        export BCPL64PATH=$BCPL64ROOT/cin
        export BCPL64HDRS=$BCPL64ROOT/g
        export PATH=$PATH:$BCPL64ROOT
or
        setenv BCPL64ROOT ${HOME}/distribution/BCPL64/cintcode
        setenv BCPL64PATH ${BCPL64ROOT}/cin
        setenv BCPL64HDRS ${BCPL64ROOT}/g
        setenv PATH     ${PATH}:${BCPL64ROOT}

4) Change to the cintcode directory an rebuild the system (under Linux):

        cd $HOME/distribution/BCPL64/cintcode
        make clean
        make

This should have rebuilt and entered the BCPL64 Cintcode System
including recompiling all the standard commands.  The line 'make
clean' is a recent recommendation that eliminates some commonly
reported problems.

5) This step was required in earlier version of the distribution but is
hopefully is NO LONGER NEEDED. You can recompile all the BCPL64 system code
and all the commands by typing:

        c compall

6) Try out a few commands, eg:

        echo hello
        bcpl64 com/echo.b to junk
        junk hello
        map pic
        logout   (or CTRL-C)

Try "cinterp -h" to see how to set the Cintcode memory size.

7) Read the documentation in cintcode/doc and any README files you can
find, and possibly try out the demonstration script in
cintcode/doc/notes.

8) To compile and run a demo program such as bcplprogs/demos/queens.b:

        cd ../bcplprogs/demos
        cintsys
        c b queens
        queens
        c b squad
        squad
        c b squad2
        squad2


Have fun and good luck!


Martin Richards
     (mr@cl.cam.ac.uk, http://www.cl.cam.ac.uk/users/mr)
University Computer Laboratory
New Museums Site                  
Pembroke Street
Cambridge
UK

3 October 2006