pi man page on 4.4BSD

Man page or keyword search:  
man Server   1065 pages
apropos Keyword Search (all sections)
Output format
4.4BSD logo
[printable version]

PI(1)			  BSD General Commands Manual			 PI(1)

NAME
     pi — Pascal interpreter code translator

SYNOPSIS
     pi [-blnpstuwz] [-i name ...] name.p

DESCRIPTION
     Pi translates the program in the file name.p leaving interpreter code in
     the file obj in the current directory.  The interpreter code can be exe‐
     cuted using px.  Pix performs the functions of pi and px for `load and
     go' Pascal.

     The following flags are interpreted by pi; the associated options can
     also be controlled in comments within the program as described in the
     Berkeley Pascal User's Manual.

     -b	     Block buffer the file output.

     -i	     Enable the listing for any specified procedures and functions and
	     while processing any specified include files.

     -l	     Make a program listing during translation.

     -n	     Begin each listed include file on a new page with a banner line.

     -p	     Suppress the post-mortem control flow backtrace if an error
	     occurs; suppress statement limit counting.

     -s	     Accept standard Pascal only; non-standard constructs cause warn‐
	     ing diagnostics.

     -t	     Suppress runtime tests of subrange variables and treat assert
	     statements as comments.

     -u	     Card image mode; only the first 72 characters of input lines are
	     used.

     -w	     Suppress warning diagnostics.

     -z	     Allow execution profiling with pxp by generating statement coun‐
	     ters, and arranging for the creation of the profile data file
	     pmon.out when the resulting object is executed.

FILES
     file.p		    Input file.
     file.i		    Include file(s).
     /usr/lib/pi2.*strings  Text of the error messages.
     /usr/lib/how_pi*	    Basic usage explanation.
     obj		    Interpreter code output.

SEE ALSO
     pix(1), px(1), pxp(1), pxref(1)

     Berkeley Pascal User's Manual.

DIAGNOSTICS
     For a basic explanation do

	   pi

     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.

     Semantic error diagnostics indicate a line in the source text near the
     point of error.  Some errors evoke more than one diagnostic to help pin‐
     point the error; the follow-up messages begin with an ellipsis `...'.

     The first character of each error message indicates its class:

	   E	   Fatal error; no code will be generated.
	   e	   Non-fatal error.
	   w	   Warning - a potential problem.
	   s	   Non-standard Pascal construct warning.

     If a severe error occurs which inhibits further processing, the transla‐
     tor will give a diagnostic and then ‘QUIT’.

BUGS
     The keyword packed is recognized but has no effect.

     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 procedure or function rather than
     evoking many diagnostics.

     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.

HISTORY
     The Pi command appeared in 3.0BSD.

4th Berkeley Distribution	 June 6, 1993	     4th Berkeley Distribution
[top]

List of man pages available for 4.4BSD

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
...................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net