pi(1)pi(1)Namepi - Pascal interpreter code translator
Syntaxpi [options] [-i name...] name.p
Description
The command translates the program in the file name.p leaving inter‐
preter code in the file obj in the current directory. The interpreter
code can be executed using The command performs the functions of and
for `load and go' Pascal.
Options
The following flags are interpreted by The associated options can also
be controlled in comments within the program as described in the
"Berkeley Pascal User's Manual" in the Supplementary Documents, Volume
2: Programmer.
-b Block buffers the file output.
-i Enables listing for specified procedures and functions and while
processing specified files.
-l Creates a program listing while translating source.
-n Begins each listed file on a new page with a banner line.
-p Suppresses control flow backtrace on error; suppresses statement
limit counting.
-s Accepts standard Pascal only; non-standard constructs cause warn‐
ing diagnostics.
-t Suppresses runtime tests of subrange variables and treat; treats
statements as comments.
-u Runs in card image mode; only the first 72 characters of input
lines are used.
-w Suppresses all warning diagnostics.
-z Enables execution profiling with by generating statement counters,
and arranging for the creation of the profile data file pmon.out
when the resulting object is executed.
Restrictions
The keyword packed is recognized but has no effect.
When include files are present, diagnostics relating to the last proce‐
dure in one file may appear after the beginning of the listing of the
next.
Diagnostics
For a basic explanation type:
pi
In the diagnostic output of the translator, lines containing syntax
errors are listed with a flag indicating the point of error. Diagnos‐
tic messages indicate the action which the recovery mechanism took in
order to be able to continue parsing. Some diagnostics indicate only
that the input is `malformed.' This occurs if the recovery can find no
simple correction to make the input syntactically valid.
Semantic error diagnostics indicate a line in the source text near the
point of error. Some errors evoke more than one diagnostic to help
pinpoint the error; the follow-up messages begin with an ellipsis
`...'.
The first character of each error message indicates its class:
EFatal error; no code is generated.
eNon-fatal error.
wWarning - a potential problem.
sNon-standard Pascal construct warning.
If a severe error occurs which inhibits further processing, the trans‐
lator gives a diagnostic and then `QUIT'.
Files
file.p input file
file.i include file(s)
/usr/lib/pi3.*stringstext of the error messages
/usr/lib/how_pi*basic usage explanation
obj interpreter code output
See Alsopix(1), px(1), pxp(1), pxref(1)
"Berkeley Pascal User's Manual", Supplementary Documents, Volume 2:
Programmer
VAX pi(1)