.\" Copyright (c) 1980, 1990 The Regents of the University of California.
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" 1. Redistributions of source code must retain the above copyright
.\" notice, this list of conditions and the following disclaimer.
.\" 2. Redistributions in binary form must reproduce the above copyright
.\" notice, this list of conditions and the following disclaimer in the
.\" documentation and/or other materials provided with the distribution.
.\" 3. All advertising materials mentioning features or use of this software
.\" must display the following acknowledgement:
.\" This product includes software developed by the University of
.\" California, Berkeley and its contributors.
.\" 4. Neither the name of the University nor the names of its contributors
.\" may be used to endorse or promote products derived from this software
.\" without specific prior written permission.
.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" @(#)pi.1 6.5 (Berkeley) 5/9/91
.Nd Pascal interpreter code translator
translates the program in the file
leaving interpreter code in the file
in the current directory.
The interpreter code can be executed using
performs the functions of
for `load and go' Pascal.
The following flags are interpreted by
the associated options can also be controlled in comments within the program
.%T "Berkeley Pascal User's Manual" .
any specified procedures and functions and while processing any specified
Make a program listing during translation.
file on a new page with a banner line.
Suppress the post-mortem control flow backtrace
suppress statement limit counting.
Accept standard Pascal only;
non-standard constructs cause warning diagnostics.
Suppress runtime tests of subrange variables and treat
only the first 72 characters of input lines are used.
Suppress warning diagnostics.
Allow execution profiling with
by generating statement counters, and arranging for the
creation of the profile data file
when the resulting object is executed.
.Bl -tag -width /usr/lib/pi1.*strings -compact
.It Pa /usr/lib/pi2.*strings
Text of the error messages.
.%T "Berkeley Pascal User's Manual"
For a basic explanation do
.Bd -literal -offset indent
In the diagnostic output of the translator,
lines containing syntax errors are listed with a flag indicating the
Diagnostic 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
Semantic error diagnostics indicate a line in the source text near the
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:
.Bl -tag -width indent -compact -offset indent
Fatal error; no code will be generated.
Warning \- a potential problem.
Non-standard Pascal construct warning.
If a severe error occurs which inhibits further processing,
the translator will give a diagnostic and then
is recognized but has no effect.
semantic errors should be flagged at an appropriate place in the source text,
and multiple instances of the `same' semantic error should be summarized
rather than evoking many diagnostics.
diagnostics relating to the last procedure in one file may appear after the
beginning of the listing of the next.