[unix-history] / usr / src / usr.bin / pascal / px / px.1

.\" Copyright (c) 1980 Regents of the University of California.
.\" All rights reserved.  The Berkeley software License Agreement
.\" specifies the terms and conditions for redistribution.
.\"
.\"	@(#)px.1	6.2 (Berkeley) %G%
.\"
.TH PX 1 ""
.UC
.SH NAME
px \- Pascal interpreter
.SH SYNOPSIS
.B px
[ obj [ argument ... ] ]
.SH DESCRIPTION
.I Px
interprets the abstract machine code generated by
.I pi.
The first argument is the file to be interpreted, and defaults
to
.IR obj \|;
remaining arguments are available to the Pascal program using the
built-ins
.I argv
and
.I argc.
.I Px
is also invoked by
.I pix
when running `load and go'.
.PP
If the program terminates abnormally an error message and a 
control flow backtrace are printed.
The number of statements executed and total execution time
are printed after normal termination.
The
.B p
option of
.I pi
suppresses all of this except the message indicating the cause
of abnormal termination.
.SH FILES
.DT
obj		default object file
.br
pmon.out	profile data file
.SH "SEE ALSO"
Berkeley Pascal User's Manual
.br
pi(1), pix(1)
.SH DIAGNOSTICS
Most run-time error messages are self-explanatory.
Some of the more unusual ones are:
.HP 6
Reference to an inactive file
.br
A file other than
.I input
or
.I output
was used before a call to
.I reset
or
.I rewrite.
.HP 6
Statement count limit exceeded
.br
The limit of 500,000 executed statements
(which prevents excessive looping or recursion)
has been exceeded.
.HP 6
Bad data found on integer read
.br
.ns
.HP 6
Bad data found on real read
.br
Usually, non-numeric input was found for a number.
For reals, Pascal requires digits before and after the decimal
point so that numbers like `.1' or `21.' evoke the second diagnostic.
.HP 6
panic:
.I  "Some message"
.br
Indicates an internal inconsistency detected in
.I px
probably due to a Pascal system bug.
.SH AUTHORS
Charles B. Haley, William Joy, and Ken Thompson
.br
VAX-11 version by Kirk McKusick
.SH BUGS
Post-mortem traceback is not limited;
infinite recursion leads to almost infinite traceback.
Commit	Line	Data
8970a365 KM	1	.\" Copyright (c) 1980 Regents of the University of California.
	2	.\" All rights reserved. The Berkeley software License Agreement
	3	.\" specifies the terms and conditions for redistribution.
	4	.\"
c33a908d	5	.\" @(#)px.1 6.2 (Berkeley) %G%
8970a365	6	.\"
290df862	7	.TH PX 1 ""
8970a365 KM	8	.UC
	9	.SH NAME
	10	px \- Pascal interpreter
	11	.SH SYNOPSIS
	12	.B px
	13	[ obj [ argument ... ] ]
	14	.SH DESCRIPTION
	15	.I Px
	16	interprets the abstract machine code generated by
	17	.I pi.
	18	The first argument is the file to be interpreted, and defaults
	19	to
	20	.IR obj \\|;
	21	remaining arguments are available to the Pascal program using the
	22	built-ins
	23	.I argv
	24	and
	25	.I argc.
	26	.I Px
	27	is also invoked by
	28	.I pix
	29	when running `load and go'.
	30	.PP
	31	If the program terminates abnormally an error message and a
	32	control flow backtrace are printed.
	33	The number of statements executed and total execution time
	34	are printed after normal termination.
	35	The
	36	.B p
	37	option of
	38	.I pi
	39	suppresses all of this except the message indicating the cause
	40	of abnormal termination.
	41	.SH FILES
	42	.DT
	43	obj default object file
	44	.br
	45	pmon.out profile data file
	46	.SH "SEE ALSO"
	47	Berkeley Pascal User's Manual
	48	.br
	49	pi(1), pix(1)
	50	.SH DIAGNOSTICS
	51	Most run-time error messages are self-explanatory.
	52	Some of the more unusual ones are:
	53	.HP 6
	54	Reference to an inactive file
	55	.br
	56	A file other than
	57	.I input
	58	or
	59	.I output
	60	was used before a call to
	61	.I reset
	62	or
	63	.I rewrite.
	64	.HP 6
	65	Statement count limit exceeded
	66	.br
	67	The limit of 500,000 executed statements
	68	(which prevents excessive looping or recursion)
	69	has been exceeded.
	70	.HP 6
	71	Bad data found on integer read
72	.br
73	.ns
74	.HP 6
75	Bad data found on real read
76	.br
77	Usually, non-numeric input was found for a number.
78	For reals, Pascal requires digits before and after the decimal
79	point so that numbers like `.1' or `21.' evoke the second diagnostic.
80	.HP 6
81	panic:
82	.I "Some message"
83	.br
c33a908d	84	Indicates an internal inconsistency detected in
8970a365 KM	85	.I px
	86	probably due to a Pascal system bug.
	87	.SH AUTHORS
	88	Charles B. Haley, William Joy, and Ken Thompson
	89	.br
	90	VAX-11 version by Kirk McKusick
	91	.SH BUGS
	92	Post-mortem traceback is not limited;
	93	infinite recursion leads to almost infinite traceback.