Return to bprint.1 CVS log

Up to [Research Unix] / researchv10no / cmd / lcc / etc

Annotation of researchv10no/cmd/lcc/etc/bprint.1, revision 1.1

1.1     ! root        1: .TH BPRINT 1 "local \- 9/24/91"
        !             2: .SH NAME
        !             3: bprint \- expression profiler
        !             4: .SH SYNOPSIS
        !             5: .B bprint
        !             6: [
        !             7: .I option ...
        !             8: ]
        !             9: [
        !            10: .I file ...
        !            11: ]
        !            12: .SH DESCRIPTION
        !            13: .I bprint
        !            14: produces on the standard output a listing of the programs compiled by
        !            15: .I lcc
        !            16: with the
        !            17: .B \-b
        !            18: option.
        !            19: Executing an
        !            20: .B a.out
        !            21: so compiled appends profiling data to
        !            22: .BR prof.out .
        !            23: The first token of each expression in the listing is preceded
        !            24: by the number of times it was executed
        !            25: enclosed in angle brackets as determined from the data in
        !            26: .BR prof.out .
        !            27: .I bprint
        !            28: interprets the following options.
        !            29: .TP
        !            30: .B \-c
        !            31: Compress the
        !            32: .B prof.out
        !            33: file, which otherwise grows with every execution of
        !            34: .BR a.out .
        !            35: .TP
        !            36: .B \-b
        !            37: Print an annotated listing as described above.
        !            38: .TP
        !            39: .B \-n
        !            40: Include line numbers in the listing.
        !            41: .TP
        !            42: .B \-f
        !            43: Print only the number of invocations of each function.
        !            44: A second
        !            45: .B \-f
        !            46: summarizes call sites instead of callers.
        !            47: .TP
        !            48: .SM
        !            49: .BI \-I \*Sdir
        !            50: specifies additional directories in which to seek
        !            51: files given in
        !            52: .B prof.out
        !            53: that do not begin with `/'.
        !            54: .PP
        !            55: If any file names are given, only the requested data for those files are printed
        !            56: in the order presented.
        !            57: If no options are given,
        !            58: .B \-b
        !            59: is assumed.
        !            60: .SH FILES
        !            61: .PP
        !            62: .ta \w'/usr/lib/bbexit.oXX'u
        !            63: prof.out       profiling data
        !            64: .br
        !            65: /usr/lib/bbexit.o      creates
        !            66: .B prof.out
        !            67: when
        !            68: .B a.out
        !            69: exits
        !            70: .SH "SEE ALSO"
        !            71: .IR lcc (1), 
        !            72: .IR prof (1)
        !            73: .SH BUGS
        !            74: Macros and comments can confuse
        !            75: .I bprint
        !            76: because it uses post-expansion source coordinates
        !            77: to annotate pre-expansion source files.
        !            78: If
        !            79: .I bprint
        !            80: sees that it's about to print a statement count
        !            81: .I inside
        !            82: a number or identifier, it moves the count to just
        !            83: .I before
        !            84: the token.
        !            85: .PP
        !            86: Can't cope with an ill-formed
        !            87: .BR prof.out .

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