Return to pxp.1 CVS log

Up to [CSRG BSD Unix] / 43BSDTahoe / man / man1

Annotation of 43BSDTahoe/man/man1/pxp.1, revision 1.1

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

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.