# 2.11BSD#431 - /usr/man/cat1/pxp.0

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

    NAME
         pxp - Pascal execution profiler

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

    DESCRIPTION
         Pxp 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 pi or pix, 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 pxp is discussed in sec-
         tions 2.6, 5.4, 5.5 and 5.10 of the Berkeley Pascal User's
         Manual.

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

         -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 names, 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 pxp 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 pi; `Not a Pas-
         cal system core file' if the core is not from a px 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

Generated: 2016-12-26 | Generated by man2html V0.25 page hit count: 307 |