NAME

pxp − Pascal execution profiler and prettyprinter

SYNOPSIS

pxp [ −acdefjLnOstuw_ ] [ −23456789 ] [ −z [ name ... ] ] name.p

DESCRIPTION

pxp can be used to obtain execution profiles of Pascal programs or as a prettyprinter.  To produce an execution profile all that is necessary is to translate the program specifying the z option to pc, execute the program, and then type the command

tutorial% pxp −z name.p

pxp generates a reformatted listing if none of the c, t, or z options are specified; thus

tutorial% pxp old.p > new.p

places a cleaned-up version of the program in old.p in the file new.p. 

OPTIONS

The use of the following options of pxp is discussed in the Sun Pascal Progammer’s Guide.

−a Print the bodies of all procedures and functions in the profile; even those which were never executed. 

−c Extract profile data from the file core.

−d Exclude declaration parts from a profile. 

−e Eliminate include directives when reformatting a file; the include is replaced by the reformatted contents of the specified file. 

−f Fully parenthesize expressions. 

−j Left-justify all procedures and functions. 

−L Map all identifiers and keywords to lower case. 

−n Eject a new page as each file is included; in profiles, print a blank line at the top of the page. 

−O Replace others: in case statements with an equivalent standard Pascal construction.  (This is used primarily in compiling TEX.) 

−s Strip comments from the input text. 

−t Print a table summarizing procedure and function call counts. 

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

−w Suppress warning diagnostics. 

−z [ name ... ] name.p
Generate an execution profile.  If no names are given, the profile is of the entire program. If a list of names is given, then only the specified procedures or functions and the contents of the specified include files will appear in the profile. 

−_ Underline keywords. 

−d Use d spaces (where d is a digit, 2 ≤ d ≤ 9) as the basic indenting unit.  The default is 4. 

FILES

name.p input file

name.i include file

name.h include file

pmon.out profile data

core profile data source for −c option

/usr/lib/how_pxp
information on basic use

/usr/man/man1/pxp.1
this manual page

/usr/ucb/pxp executable file

SEE ALSO

pc(1)

Sun Pascal Programmer’s Guide

DIAGNOSTICS

For a basic explanation do

tutorial% pxp

Error diagnostics include ‘Program and count data do not correspond’ if the program was changed after compilation, before profiling; or if the wrong program is specified. 

BUGS

Does not place multiple statements per line. 

Procedures and functions as parameters are printed without nested parameter lists, as in the obsolete Jensen and Wirth syntax. 

Sun Release 4.0  —  Last change: 23 May 1988