[unix-history] / usr / man / man1 / pi.1

.TH PI 1 4/8/79
.UC
.SH NAME
pi \- Pascal interpreter code translator
.SH SYNOPSIS
.B pi
[
.B \-blnpstuwz
] [
.B \-i
name ...
] name.p
.SH DESCRIPTION
.I Pi
translates the program in the file
.I name.p
leaving interpreter code in the file
.I obj
in the current directory.
The interpreter code can be executed using
.I px.
.I Pix
performs the functions of
.I pi
and
.I px
for `load and go' Pascal.
.PP
The following flags are interpreted by 
.I pi;
the associated options can also be controlled in comments within the program
as described in the
.I "Berkeley Pascal User's Manual."
.TP 6
.B  \-b
Block buffer the file
.I output.
.TP 6
.B  \-i
Enable the listing for
any specified procedures and functions and while processing any specified
.B include
files.
.TP 6
.B  \-l
Make a program listing during translation.
.TP 6
.B  \-n
Begin each listed
.B include
file on a new page with a banner line.
.TP 6
.B  \-p
Suppress the post-mortem control flow backtrace
if an error occurs;
suppress statement limit counting.
.TP 6
.B  \-s
Accept standard Pascal only;
non-standard constructs cause warning diagnostics.
.TP 6
.B  \-t
Suppress runtime tests of subrange variables and treat
.B assert
statements as comments.
.TP 6
.B  \-u
Card image mode;
only the first 72 characters of input lines are used.
.TP 6
.B  \-w
Suppress warning diagnostics.
.TP 6
.B  \-z
Allow execution profiling with
.I pxp
by generating statement counters, and arranging for the
creation of the profile data file
.I pmon.out
when the resulting object is executed.
.dt
.SH FILES
file.p				input file
.br
file.i				\fBinclude\fR file(s)
.br
/usr/lib/pi_strings		text of the error messages
.br
.nf
/usr/lib/how_pi*		basic usage explanation
.fi
obj				interpreter code output
.SH "SEE ALSO"
Berkeley Pascal User's Manual
.br
pix(1),
px(1),
pxp(1),
pxref(1)
.SH DIAGNOSTICS
For a basic explanation do
.IP
.B	pi
.PP
In the diagnostic output of the translator,
lines containing syntax errors are listed with a flag indicating the
point of error.
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
syntactically valid.
.LP
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 `...'.
.LP
.ne 8
The first character of each error message indicates its class:
.LP
.ta 1ic 2.i
	E	Fatal error; no code will be generated.
.br
	e	Non-fatal error.
.br
	w	Warning \- a potential problem.
.br
	s	Non-standard Pascal construct warning.
.LP
If a severe error occurs which inhibits further processing,
the translator will give a diagnostic and then `QUIT'.
.SH AUTHORS
Charles B. Haley, William N. Joy, and Ken Thompson
.br
Ported to VAX-11 by Peter Kessler
.SH BUGS
Formal parameters which are procedures and functions are not supported.
.PP
The keyword
.B packed
and the function
.I dispose
are recognized but have no effect.
.PP
For clarity,
semantic errors should be flagged at an appropriate place in the source text,
and multiple instances of the `same' semantic error should be summarized
at the end of a
.B procedure
or
.B function
rather than evoking many diagnostics.
.PP
When
.B include
files are present,
diagnostics relating to the last procedure in one file may appear after the
beginning of the listing of the next.
Commit	Line	Data
687cfdae CH	1	.TH PI 1 4/8/79
	2	.UC
	3	.SH NAME
	4	pi \- Pascal interpreter code translator
	5	.SH SYNOPSIS
	6	.B pi
	7	[
	8	.B \-blnpstuwz
	9	] [
	10	.B \-i
	11	name ...
	12	] name.p
	13	.SH DESCRIPTION
	14	.I Pi
	15	translates the program in the file
	16	.I name.p
	17	leaving interpreter code in the file
	18	.I obj
	19	in the current directory.
	20	The interpreter code can be executed using
	21	.I px.
	22	.I Pix
	23	performs the functions of
	24	.I pi
	25	and
	26	.I px
	27	for `load and go' Pascal.
	28	.PP
	29	The following flags are interpreted by
	30	.I pi;
	31	the associated options can also be controlled in comments within the program
	32	as described in the
	33	.I "Berkeley Pascal User's Manual."
	34	.TP 6
	35	.B \-b
	36	Block buffer the file
	37	.I output.
	38	.TP 6
	39	.B \-i
	40	Enable the listing for
	41	any specified procedures and functions and while processing any specified
	42	.B include
	43	files.
	44	.TP 6
	45	.B \-l
	46	Make a program listing during translation.
	47	.TP 6
	48	.B \-n
	49	Begin each listed
	50	.B include
	51	file on a new page with a banner line.
	52	.TP 6
	53	.B \-p
	54	Suppress the post-mortem control flow backtrace
	55	if an error occurs;
	56	suppress statement limit counting.
	57	.TP 6
	58	.B \-s
	59	Accept standard Pascal only;
	60	non-standard constructs cause warning diagnostics.
	61	.TP 6
	62	.B \-t
	63	Suppress runtime tests of subrange variables and treat
	64	.B assert
65	statements as comments.
66	.TP 6
67	.B \-u
68	Card image mode;
69	only the first 72 characters of input lines are used.
70	.TP 6
71	.B \-w
72	Suppress warning diagnostics.
73	.TP 6
74	.B \-z
75	Allow execution profiling with
76	.I pxp
77	by generating statement counters, and arranging for the
78	creation of the profile data file
79	.I pmon.out
80	when the resulting object is executed.
81	.dt
82	.SH FILES
83	file.p input file
84	.br
85	file.i \fBinclude\fR file(s)
86	.br
87	/usr/lib/pi_strings text of the error messages
88	.br
89	.nf
90	/usr/lib/how_pi* basic usage explanation
91	.fi
92	obj interpreter code output
93	.SH "SEE ALSO"
94	Berkeley Pascal User's Manual
95	.br
96	pix(1),
97	px(1),
98	pxp(1),
99	pxref(1)
100	.SH DIAGNOSTICS
101	For a basic explanation do
102	.IP
103	.B pi
104	.PP
105	In the diagnostic output of the translator,
106	lines containing syntax errors are listed with a flag indicating the
107	point of error.
108	Diagnostic messages indicate the action which the recovery mechanism
109	took in order to be able to continue parsing.
110	Some diagnostics indicate only that the input is `malformed.'
111	This occurs if the recovery can find no simple correction to make the input
112	syntactically valid.
113	.LP
114	Semantic error diagnostics indicate a line in the source text near the
115	point of error.
116	Some errors evoke more than one diagnostic to help pinpoint the error;
117	the follow-up messages begin with an ellipsis `...'.
118	.LP
119	.ne 8
120	The first character of each error message indicates its class:
121	.LP
122	.ta 1ic 2.i
123	E Fatal error; no code will be generated.
124	.br
125	e Non-fatal error.
126	.br
127	w Warning \- a potential problem.
128	.br
129	s Non-standard Pascal construct warning.
130	.LP
131	If a severe error occurs which inhibits further processing,
132	the translator will give a diagnostic and then `QUIT'.
133	.SH AUTHORS
134	Charles B. Haley, William N. Joy, and Ken Thompson
135	.br
136	Ported to VAX-11 by Peter Kessler
137	.SH BUGS
138	Formal parameters which are procedures and functions are not supported.
139	.PP
140	The keyword
141	.B packed
142	and the function
143	.I dispose
144	are recognized but have no effect.
145	.PP
146	For clarity,
147	semantic errors should be flagged at an appropriate place in the source text,
148	and multiple instances of the `same' semantic error should be summarized
149	at the end of a
150	.B procedure
151	or
152	.B function
153	rather than evoking many diagnostics.
154	.PP
155	When
156	.B include
157	files are present,
158	diagnostics relating to the last procedure in one file may appear after the
159	beginning of the listing of the next.