User guide

106 CHAPTER 4. THE COMMAND LANGUAGE
adjclock OFFSET CIN:y, POS:y, NAT:y
The syntax of the OFFSET argument is [-][h][:m], that is: an optional minus sign,
followed by an opti onal number of hours, possibly followed by :m to spe ci f y a number
of minutes. The offset is converted into a signe d integer representing the number of
minutes to be added to the time of day as supplied by the system. If adjclock is not
given an argument, it just outputs the current offset.
alarm AT/A,MESSAGE CIN:n, POS:y, NAT:n
This command is only available under Cintpos. Its first parameter has the format:
[+][[hours:]minutes:]seconds. If + is present the time is relative to now. The
command suspends itself until the specified time, then outputs the time followed by
the message. Typical usage is as follows:
run alarm +3:30 "You time is up!"
After three and a half minute a message such as the following will appear.
*** Alarm: time is 15:13:14 - You time is up!
append FROM,TO/K CIN:y, POS:y, NAT:y
This command appends the FROM file on to t he end of the TO file. If the TO file does
not initially exist, an empty one is created.
bcpl FROM/A,TO/K,VER/K,SIZE/K/N,TREE/S,NONAMES/S,
D1/S,D2/S,OENDER/S,EQCASES/S,BIN/S,XREF/S,GDEFS/S,HDRS/K,
GB2312/S,UTF8/S,SAVESIZE/K/N,HARD/S,T32/S,T64/S,
OPT/K CIN:y, POS:y, NAT:y
This invokes the BCPL comp i l er . The FROM argument specified the name of the file
to be compiled. If the TO argument is given, the compil er generates code to the specified
file. Without the TO argument the compiler will outpu t the OCODE intermediate
form to the file ocode as a compiler debugging aid. This file can be conver te d to a
more readable form usinf the procode command, described below. The VER argument
redirects the standard output to a named file. The SIZE argument specified the size
of the compiler’s work space. The default is 100,000 words. The NONAMES switch
causes the compiler not include section and functi on names in the compiled code. The
switches D1 and D2 control compiler debugging output. D1 causes a readable form of the
compiled Cintcode to be output. D2 causes a detailed trace of the internal working of
the codegenerator to be output. D1 and D2 together causes a slightly more detailed trace
of the internal working of the codegenerator. OENDER causes code to be generated for a
machine with the opposite en di ane ss of the machine on which the compiler is running.
EQCASES causes all identi fie r s to be converted to uppercase during compilati on. This
allows very old BCPL programs to be compiled. BIN causes the tar get Cintcode to be
in binary rather than the ASCII encoded hexadecimal normally used. The XREF option