4.3BSD-Reno/share/man/cat1/pxp.0

PXP(1)			    UNIX Reference Manual			PXP(1)

NNAAMMEE
     ppxxpp - Pascal execution profiler

SSYYNNOOPPSSIISS
     ppxxpp [--aaccddeeffjjnnssttuuww__] [--2233445566778899] [--zz [_n_a_m_e ...]] _n_a_m_e._p

DDEESSCCRRIIPPTTIIOONN
     PPxxpp can be used to obtain execution profiles of Pascal programs or as a
     pretty-printer.  To produce an execution profile all that is necessary is
     to translate the program specifying the --zz option to pi(1) or pix(1), to
     execute the program, and to then issue the command

	   pxp -x name.p

     A reformatted listing is output if none of the --cc, --tt, or --zz options are
     specified; thus

	   pxp old.p > new.p

     places a pretty-printed version of the program in `old.p' in the file
     `new.p'.

     The use of the following options of ppxxpp is discussed in sections 2.6,
     5.4, 5.5 and 5.10 of the _B_e_r_k_e_l_e_y _P_a_s_c_a_l _U_s_e_r'_s _M_a_n_u_a_l.

     --aa        Print the bodies of all procedures and functions in the pro-
	       file; even those which were never executed.

     --cc        Extract profile data from the file _c_o_r_e.

     --dd        Include declaration parts in a profile.

     --ee        Eliminate iinncclluuddee directives when reformatting a file; the
	       iinncclluuddee is replaced by the reformatted contents of the speci-
	       fied file.

     --ff        Fully parenthesize expressions.

     --jj        Left justify all procedures and functions.

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

     --ss        Strip comments from the input text.

     --tt        Print a table summarizing pprroocceedduurree and ffuunnccttiioonn call counts.

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

     --ww        Suppress warning diagnostics.

     --zz        Generate an execution profile.  If no _n_a_m_e's are given the
	       profile is of the entire program.  If a list of names is given,
	       then only any specified pprroocceedduurrees or ffuunnccttiioonns and the
	       contents of any specified iinncclluuddee files will appear in the pro-
	       file.

     --__        Underline keywords.

     --dd        With _d a digit, 2 <_ _d <_ 9, causes ppxxpp to use _d spaces as the
	       basic indenting unit.  The default is 4.

FFIILLEESS
     _n_a_m_e._p		input file
     _n_a_m_e._i		include file(s)
     _p_m_o_n._o_u_t		profile data
     _c_o_r_e		profile data source with --cc
     /_u_s_r/_l_i_b/_h_o_w__p_x_p	information on basic usage


SSEEEE AALLSSOO
     _B_e_r_k_e_l_e_y _P_a_s_c_a_l _U_s_e_r'_s _M_a_n_u_a_l
     pi(1), px(1)

DDIIAAGGNNOOSSTTIICCSS
     For a basic explanation do

	   ppxxpp

     Error diagnostics include `No profile data in file' with the --cc option if
     the --zz option was not enabled to ppii; `Not a Pascal system core file' if
     the core is not from a ppxx execution; `Program and count data do not
     correspond' if the program was changed after compilation, before profil-
     ing; or if the wrong program is specified.

AAUUTTHHOORR
     William Joy

HHIISSTTOORRYY
     PPxxpp appeared in 3 BSD.

BBUUGGSS
     Does not place multiple statements per line.