1PXP(1)                      General Commands Manual                     PXP(1)
2
3
4

NAME

6       pxp - Pascal execution profiler
7

SYNOPSIS

9       pxp [ -acdefjnstuw_ ] [ -23456789 ] [ -z [ name ... ] ] name.p
10

DESCRIPTION

12       Pxp can be used to obtain execution profiles of Pascal programs or as a
13       pretty-printer.  To produce an execution profile all that is  necessary
14       is  to  translate  the program specifying the z option to pi or pix, to
15       execute the program, and to then issue the command
16
17            pxp -z name.p
18
19       A reformatted listing is output if none of the c, t, or z  options  are
20       specified; thus
21
22            pxp old.p > new.p
23
24       places  a  pretty-printed version of the program in `old.p' in the file
25       `new.p'.
26
27       The use of the following options of pxp is discussed in  sections  2.6,
28       5.4, 5.5 and 5.10 of the Berkeley Pascal User's Manual.
29
30       -a    Print  the bodies of all procedures and functions in the profile;
31             even those which were never executed.
32
33       -c    Extract profile data from the file core.
34
35       -d    Include declaration parts in a profile.
36
37       -e    Eliminate  include  directives  when  reformatting  a  file;  the
38             include  is replaced by the reformatted contents of the specified
39             file.
40
41       -f    Fully parenthesize expressions.
42
43       -j    Left justify all procedures and functions.
44
45       -n    Eject a new page as each file is included; in profiles,  print  a
46             blank line at the top of the page.
47
48       -s    Strip comments from the input text.
49
50       -t    Print a table summarizing procedure and function call counts.
51
52       -u    Card  image mode; only the first 72 characters of input lines are
53             used.
54
55       -w    Suppress warning diagnostics.
56
57       -z    Generate an execution profile.  If no names, are given  the  pro‐
58             file is of the entire program.  If a list of names is given, then
59             only any specified procedures or functions and  the  contents  of
60             any specified include files will appear in the profile.
61
62       -_    Underline keywords.
63
64       -d    With  d  a  digit,  2  ≤ d ≤ 9, causes pxp to use d spaces as the
65             basic indenting unit.  The default is 4.
66

FILES

68       name.p              input file
69       name.i              include file(s)
70       pmon.out            profile data
71       core                profile data source with -c
72       /usr/share/pascal/how_pxpinformation on basic usage
73

SEE ALSO

75       Berkeley Pascal User's Manual
76       pi(1), px(1)
77

DIAGNOSTICS

79       For a basic explanation do
80
81              pxp
82
83       Error diagnostics include `No profile data in file' with the  c  option
84       if  the z option was not enabled to pi; `Not a Pascal system core file'
85       if the core is not from a px execution; `Program and count data do  not
86       correspond'  if  the program was changed after compilation, before pro‐
87       filing; or if the wrong program is specified.
88

AUTHOR

90       William N. Joy
91

BUGS

93       Does not place multiple statements per line.
94
95
96
973rd Berkeley Distribution                                               PXP(1)
Impressum