Manual page for PXP(1)
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.
Created by unroff & hp-tools.
© by Hans-Peter Bischof. All Rights Reserved (1997).
Last modified 21/April/97
