Commit | Line | Data |
---|---|---|
70e18513 BJ |
1 | .TH PXP UCB 4/8/79 UCB |
2 | .SH NAME | |
3 | pxp \- Pascal execution profiler | |
4 | .SH SYNOPSIS | |
5 | .B pxp | |
6 | [ | |
7 | .B \-acdefjnstuw_ | |
8 | ] [ | |
9 | .B \-23456789 | |
10 | ] [ | |
11 | .B \-z | |
12 | [ name ... ] ] name.p | |
13 | .SH DESCRIPTION | |
14 | .I Pxp | |
15 | can be used to obtain execution profiles of Pascal programs or | |
16 | as a pretty-printer. | |
17 | To produce an execution profile all that is necessary is to translate | |
18 | the program specifying the | |
19 | .B z | |
20 | option to | |
21 | .I pi | |
22 | or | |
23 | .I pix, | |
24 | to execute the program, | |
25 | and to then issue the command | |
26 | .DT | |
27 | .PP | |
28 | \fBpxp \-z\fR name.p | |
29 | .PP | |
30 | A reformatted listing is output if none of the | |
31 | .BR c , | |
32 | .BR t , | |
33 | or | |
34 | .B z | |
35 | options are specified; | |
36 | thus | |
37 | .PP | |
38 | \fBpxp\fR old.p > new.p | |
39 | .PP | |
40 | places a pretty-printed version of the program in `old.p' in the file `new.p'. | |
41 | .PP | |
42 | The use of the following options of | |
43 | .I pxp | |
44 | is discussed in sections 2.6, 5.4, 5.5 and 5.10 of the | |
45 | .IR "Berkeley Pascal User's Manual" "." | |
46 | .TP 6 | |
47 | .B \-a | |
48 | Print the bodies of all procedures and functions in the profile; | |
49 | even those which were never executed. | |
50 | .TP 6 | |
51 | .B \-c | |
52 | Extract profile data from the file | |
53 | .IR core . | |
54 | .TP 6 | |
55 | .B \-d | |
56 | Include declaration parts in a profile. | |
57 | .TP 6 | |
58 | .B \-e | |
59 | Eliminate | |
60 | .B include | |
61 | directives when reformatting a file; | |
62 | the | |
63 | .B include | |
64 | is replaced by the reformatted contents of the specified | |
65 | file. | |
66 | .TP 6 | |
67 | .B \-f | |
68 | Fully parenthesize expressions. | |
69 | .TP 6 | |
70 | .B \-j | |
71 | Left justify all procedures and functions. | |
72 | .TP 6 | |
73 | .B \-n | |
74 | Eject a new page | |
75 | as each file is included; | |
76 | in profiles, print a blank line at the top of the page. | |
77 | .TP 6 | |
78 | .B \-s | |
79 | Strip comments from the input text. | |
80 | .TP 6 | |
81 | .B \-t | |
82 | Print a table summarizing | |
83 | .B procedure | |
84 | and | |
85 | .B function | |
86 | call counts. | |
87 | .TP 6 | |
88 | .B \-u | |
89 | Card image mode; only the first 72 characters of input lines | |
90 | are used. | |
91 | .TP 6 | |
92 | .B \-w | |
93 | Suppress warning diagnostics. | |
94 | .TP 6 | |
95 | .B \-z | |
96 | Generate an execution profile. | |
97 | If no | |
98 | .IR name \|s, | |
99 | are given the profile is of the entire program. | |
100 | If a list of names is given, then only any specified | |
101 | .BR procedure s | |
102 | or | |
103 | .BR function s | |
104 | and the contents of any specified | |
105 | .B include | |
106 | files will appear in the profile. | |
107 | .TP 6 | |
108 | .B \-\_ | |
109 | Underline keywords. | |
110 | .TP 6 | |
111 | .BI \- d | |
112 | With | |
113 | .I d | |
114 | a digit, 2 \(<= | |
115 | .IR d "" | |
116 | \(<= 9, | |
117 | causes | |
118 | .I pxp | |
119 | to use | |
120 | .IR d "" | |
121 | spaces as the basic indenting unit. | |
122 | The default is 4. | |
123 | .SH FILES | |
124 | .DT | |
125 | name.p input file | |
126 | .br | |
127 | name.i include file(s) | |
128 | .br | |
129 | pmon.out profile data | |
130 | .br | |
131 | core profile data source with | |
132 | .B \-c | |
133 | .br | |
134 | /usr/lib/how_pxp information on basic usage | |
135 | .br | |
136 | .ne 8 | |
137 | .SH "SEE ALSO" | |
138 | Berkeley Pascal User's Manual | |
139 | .br | |
140 | pi(UCB), | |
141 | px(UCB) | |
142 | .ne 5 | |
143 | .SH DIAGNOSTICS | |
144 | For a basic explanation do | |
145 | .IP | |
146 | .DT | |
147 | .B pxp | |
148 | .PP | |
149 | Error diagnostics include | |
150 | `No profile data in file' | |
151 | with the | |
152 | .B c | |
153 | option if the | |
154 | .B z | |
155 | option was not enabled to | |
156 | .I pi; | |
157 | `Not a Pascal system core file' | |
158 | if the core is not from a | |
159 | .I px | |
160 | execution; | |
161 | `Program and count data do not correspond' | |
162 | if the program was changed after compilation, before profiling; | |
163 | or if the wrong program is specified. | |
164 | .SH AUTHOR | |
165 | William N. Joy | |
166 | .SH BUGS | |
167 | Does not place multiple statements per line. |