


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



NAME
     pxp - Pascal execution profiler

SYNOPSIS
     pxp [ -acdefjnstuw_ ] [ -23456789 ] [ -z [ name ... ] ]
     name.p

DESCRIPTION
     _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 z option to _p_i or _p_i_x, to execute the pro-
     gram, and to then issue the command

	  pxp -z name.p

     A reformatted listing is output if none of the c, t, or z
     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 _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.

     -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 _c_o_r_e.

     -d    Include declaration parts in 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.

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

     -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



Printed 11/26/99						1






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



	   lines are used.

     -w    Suppress warning diagnostics.

     -z    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 procedures or
	   functions and the contents of any specified include
	   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.

FILES
     name.p		 input file
     name.i		 include file(s)
     pmon.out		 profile data
     core		 profile data source with -c
     /usr/share/pascal/how_pxpinformation on basic usage

SEE ALSO
     Berkeley Pascal User's Manual
     pi(1), px(1)

DIAGNOSTICS
     For a basic explanation do

	     pxp

     Error diagnostics include `No profile data in file' with the
     c option if the z 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.

AUTHOR
     William N. Joy

BUGS
     Does not place multiple statements per line.












Printed 11/26/99						2



