4.3BSD-Tahoe/usr/man/cat1/pxp.0

PXP(1)		    UNIX Programmer's Manual		   PXP(1)



NNAAMMEE
     pxp - Pascal execution profiler

SSYYNNOOPPSSIISS
     ppxxpp [ --aaccddeeffjjnnssttuuww__ ] [ --2233445566778899 ] [ --zz [ name ... ] ]
     name.p

DDEESSCCRRIIPPTTIIOONN
     _P_x_p can be used to obtain execution profiles of Pascal pro-
     grams or as a pretty-printer.  To produce an execution pro-
     file all that is necessary is to translate the program
     specifying the zz option to _p_i or _p_i_x, to execute the pro-
     gram, and to then issue the command

	  ppxxpp --zz name.p

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

	  ppxxpp 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 _p_x_p is discussed in sec-
     tions 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 profile; 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 specified file.

     --ff    Fully parenthesize expressions.

     --jj    Left justify all procedures and functions.

     --nn    Eject a new page as each file is included; in pro-
	   files, 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



Printed 7/9/88		 April 29, 1985                         1






PXP(1)		    UNIX Programmer's Manual		   PXP(1)



	   lines are used.

     --ww    Suppress warning diagnostics.

     --zz    Generate an execution profile.  If no _n_a_m_es, 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 profile.

     --__    Underline keywords.

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

FFIILLEESS
     name.p	    input file
     name.i	    include file(s)
     pmon.out	    profile data
     core	    profile data source with --cc
     /usr/lib/how_pxp	 information on basic usage

SSEEEE AALLSSOO
     Berkeley Pascal User's Manual
     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 _p_i; `Not a Pas-
     cal system core file' if the core is not from a _p_x execu-
     tion; `Program and count data do not correspond' if the pro-
     gram was changed after compilation, before profiling; or if
     the wrong program is specified.

AAUUTTHHOORR
     William Joy

BBUUGGSS
     Does not place multiple statements per line.












Printed 7/9/88		 April 29, 1985                         2