Return to px.1 CVS log

Up to [CSRG BSD Unix] / 43BSDReno / pgrm / pascal / px

Annotation of 43BSDReno/pgrm/pascal/px/px.1, revision 1.1.1.1

1.1       root        1: .\" Copyright (c) 1980, 1990 The Regents of the University of California.
                      2: .\" All rights reserved.
                      3: .\"
                      4: .\" Redistribution and use in source and binary forms are permitted provided
                      5: .\" that: (1) source distributions retain this entire copyright notice and
                      6: .\" comment, and (2) distributions including binaries display the following
                      7: .\" acknowledgement:  ``This product includes software developed by the
                      8: .\" University of California, Berkeley and its contributors'' in the
                      9: .\" documentation or other materials provided with the distribution and in
                     10: .\" all advertising materials mentioning features or use of this software.
                     11: .\" Neither the name of the University nor the names of its contributors may
                     12: .\" be used to endorse or promote products derived from this software without
                     13: .\" specific prior written permission.
                     14: .\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
                     15: .\" WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
                     16: .\" MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
                     17: .\"
                     18: .\"     @(#)px.1       6.4 (Berkeley) 6/26/90
                     19: .\"
                     20: .Dd June 26, 1990
                     21: .Dt PX 1
                     22: .Sh NAME
                     23: .Nm px
                     24: .Nd Pascal interpreter
                     25: .Sh SYNOPSIS
                     26: .Nm px
                     27: .Op  Ar obj Op Ar argument ...
                     28: .Sh DESCRIPTION
                     29: .Nm Px
                     30: interprets the abstract machine code generated by
                     31: .Xr pi 1 .
                     32: The first argument is the file to be interpreted, and defaults
                     33: to
                     34: .Ar obj ;
                     35: remaining arguments are available to the Pascal program using the
                     36: built-ins
                     37: .Ar argv
                     38: and
                     39: .Ar argc .
                     40: .Nm Px
                     41: is also invoked by
                     42: .Nm pix
                     43: when running `load and go'.
                     44: .Pp
                     45: If the program terminates abnormally an error message and a
                     46: control flow backtrace are printed.
                     47: The number of statements executed and total execution time
                     48: are printed after normal termination.
                     49: The
                     50: .Cm p
                     51: option of
                     52: .Nm pi
                     53: suppresses all of this except the message indicating the cause
                     54: of abnormal termination.
                     55: .Sh FILES
                     56: .Dw pmon.out
                     57: .Di L
                     58: .Dp Pa obj
                     59: default object file
                     60: .Dp Pa pmon.out
                     61: profile data file
                     62: .Dp
                     63: .Sh SEE ALSO
                     64: .Em Berkeley Pascal User's Manual
                     65: .br
                     66: .Xr pi 1 ,
                     67: .Xr pix 1
                     68: .Sh DIAGNOSTICS
                     69: Most run-time error messages are self-explanatory.
                     70: Some of the more unusual ones are:
                     71: .Tw Ds
                     72: .Tp Reference to an inactive file
                     73: A file other than
                     74: .Ar input
                     75: or
                     76: .Ar output
                     77: was used before a call to
                     78: .Ar reset
                     79: or
                     80: .Ar rewrite .
                     81: .Tp Statement count limit exceeded
                     82: The limit of 500,000 executed statements
                     83: (which prevents excessive looping or recursion)
                     84: has been exceeded.
                     85: .Tp Bad data found on integer read
                     86: .Tp Bad data found on real read
                     87: Usually, non-numeric input was found for a number.
                     88: For reals, Pascal requires digits before and after the decimal
                     89: point so that numbers like `.1' or `21.' evoke the second diagnostic.
                     90: .Tp panic:
                     91: .Em Some message
                     92: Indicates an internal inconsistency detected in
                     93: .Nm px
                     94: probably due to a Pascal system bug.
                     95: .Tp
                     96: .Sh AUTHORS
                     97: Charles B. Haley, William Joy, and Ken Thompson
                     98: .br
                     99: VAX-11 version by Kirk McKusick
                    100: .Sh HISTORY
                    101: .Nm Px
                    102: appeared in 3 BSD.
                    103: .Sh BUGS
                    104: Post-mortem traceback is not limited;
                    105: infinite recursion leads to almost infinite traceback.

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.