User guide

206 CHAPTER 12. INSTALLATION
Some web browsers will have already decompressed the .tgz file, so you may have
use the following command instead:
cd distribution
tar xvf bcpl.tgz
This step will create and populate the directories BCPL, BCPL/cintcode,
BCPL/bcplprogs and BCPL/natbcpl. The directory BCPL/cintcode contains all the
source files of the BCPL Cintcode System, BCPL/bcplprogs contains a collection of
directories holding demonstration programs, and BCPL/natbcpl contains a version of
BCPL that compiles into native code (for Intel and ALPHA machines) using a mech-
anism based on the Sial abstract machine code .
3) In order to use the BCPL Cintcode system from another directory it is neces-
sary t o define the shel l environment vari abl e s BCPLROOT, BCPLPATH, BCPLHDRS and
BCPLSCRIPTS. These environment variables must specify the absolute file names of
the BCPL root directory, the directories containing the compiled commands, the direc-
tories containing the BCPL header fil e s and the directories to be se ar ched when looking
for command-commands. The BCPLROOT directory should also be added to your PATH.
This can be done by editing the file BCPL/cintcode/os/linux/setbcplenv, if neces-
sary, and running the command:
. os/linux/setbcplenv under bash
or
source os/linux/setbcplenv under the C-shell
This will execute commands similar to:
export BCPLROOT=$HOME/distribution/BCPL/cintcode
export BCPLPATH=$BCPLROOT/cin
export BCPLHDRS=$BCPLROOT/g
export BCPLSCRIPTS=$BCPLROOT/s
export PATH=$PATH:$BCPLROOT/bin
or
setenv BCPLROOT ${HOME}/distribution/BCPL/cintcode
setenv BCPLPATH ${BCPLROOT}/cin
setenv BCPLHDRS ${BCPLROOT}/g
setenv BCPLSCRIPTS=$BCPLROOT/s
setenv PATH ${PATH}:${BCPLROOT}/bin
It is probably a good idea to add the line:
. os/linux/setbcplenv