User guide

4.3. COMMANDS 117
input TO/A,TERM/K CIN:y, POS:y, NAT:y
This command will copy text from the current input sending it the the file specified
by the AS argument. The input is te r mi nat ed by a line starting with /* or the value of
the TERM ar gum ent if given.
interpreter FAST/S,SLOW/S| CIN:y, POS:y, NAT:y
This command allows the user to select the fast (cintasm) or the slow (cinterp)
version of the interpreter. If no arguments are given the fast one is selected. It is
implemented using sys(Sys
quit,-1) or sys(Sys quit,-2) as described on page 71.
join ,,,,,,,,,,,,,,,AS/A/K,CHARS/S CIN:y, POS:y, NAT:y
This command will concatenat several files sending the result to the file specified
by the AS argument. If the CHARS switch is given the files are t r e ate d as text fil e s,
otherwise they are copied in binary.
lab LABEL/A CIN:y, POS:y, NAT:y
This command has no effect. Its sole purpos is be the destination of skip com-
mands.
library FROM,OVERRIDE/S,CANCEL/K CIN:n, POS:y, NAT:n
This rather dangerous command allows the user to add or delete sections of resident
system code. If the FROM argument is given the specified file is loaded and its sections
added to the end of the chain of BLIB sections p oi nted to by the root node field
rtn
blib. If OVERRIDE is given the newly loaded sections are allowed to r e pl ace previous
ones with the same sec ti on names, otherwise all newly loaded sections must have names
distinct from those already in th e BLIB chain. The CANCEL argument specifies the name
of a section to remove from the BLIB chain. Normally this command is only used during
the initialisation of special purpose versions of Cintsys or Cintpos.
logout CIN:y, POS:y, NAT:y
This command causes an exit from the BCPL Cintcode System, typical returning
to an operating system shell.
makeinit ,,,,,,,,,,,TO/A/K,STKSIZE/K,GLOBSIZE/K CIN:y, POS:y, NAT:y
This command is used by the native code version of BCP L to generate a C program
used to initialise a n ati ve code compilation of BCPL program. It takes a list of BCPL
source files and writes to the TO file a C program that will perform the necessary runtime
initialisation of them. This program also sets the runtime stack size and global vector
size to 50000 and 1000, respectively, unless overridden by the STKSIZE and GLOBSIZE
arguments. The r e su l ti ng C program should compiled and linked with the nati ve code
compilations of the BCPL files and various library modules. For m ore information look
in the directory BCPL/natbcpl of the standard BCPL distribution. An example of the
use of makeinit is given on page 184
map BLOCKS/S,NAMES/S,CODE/S,MAPSTORE/S,TO/K,PIC/S CIN:y, POS:y, NAT:y
This command outputs the Cintcode memory in a form that depends on the ar-
guments given. The output goes to the screen unless a filename is given using the TO