Return to pc.1 CVS log

Up to [Research Unix] / researchv10dc / man / mana

Annotation of researchv10dc/man/mana/pc.1, revision 1.1

1.1     ! root        1: .TH PC 1
        !             2: .CT 1 prog_other
        !             3: .SH NAME
        !             4: pc \- pascal language compiler
        !             5: .SH SYNOPSIS
        !             6: .B pc
        !             7: [
        !             8: .I option
        !             9: ]
        !            10: [
        !            11: .B \-i
        !            12: .I name ...
        !            13: ]
        !            14: .I name ...
        !            15: .SH DESCRIPTION
        !            16: .I Pc
        !            17: compiles the Pascal source file
        !            18: .IB name .p
        !            19: into an executable file called, by default,
        !            20: .IR a.out .
        !            21: .PP
        !            22: Multiple 
        !            23: .B .p
        !            24: files are compiled into object files suffixed
        !            25: .B .o
        !            26: in place of
        !            27: .BR .p .
        !            28: Object files may be combined by
        !            29: .IR ld (1)
        !            30: into an executable
        !            31: .I a.out
        !            32: file.
        !            33: Exactly one object file must supply a 
        !            34: .B program
        !            35: statement.
        !            36: The other files contain
        !            37: declarations which logically nest within the program.
        !            38: Objects shared between separately compiled files
        !            39: must be declared in
        !            40: .BR include d
        !            41: header files, whose names must end with
        !            42: .BR .h .
        !            43: An
        !            44: .B external
        !            45: directive, similar to
        !            46: .BR forward ,
        !            47: declares
        !            48: .BR function s
        !            49: and
        !            50: .BR procedure s
        !            51: in
        !            52: .B .h
        !            53: files.
        !            54: .PP
        !            55: These options have the same meaning as in
        !            56: .IR cc (1):
        !            57: .BR "-c -g -w -p -O -S -o" .
        !            58: The following options are peculiar to
        !            59: .IR pc .
        !            60: .TP
        !            61: .B -C
        !            62: Compile code to perform runtime checks,
        !            63: verify
        !            64: .B assert
        !            65: statements,
        !            66: and initialize variables to zero as in
        !            67: .IR pascal (1).
        !            68: .PD 0
        !            69: .TP
        !            70: .B  -b
        !            71: Block buffer the file
        !            72: .I output.
        !            73: .TP
        !            74: .B  -i
        !            75: Produce a listing for
        !            76: the specified procedures, functions and
        !            77: .B include
        !            78: files.
        !            79: .TP
        !            80: .B  -l
        !            81: Make a program listing during translation.
        !            82: .TP
        !            83: .B  -s
        !            84: Accept standard Pascal only;
        !            85: non-standard constructs cause warning diagnostics.
        !            86: .TP
        !            87: .B  -z
        !            88: Allow execution profiling with
        !            89: .IR pxp (A)
        !            90: by generating statement counters, and arranging for the
        !            91: creation of the profile data file
        !            92: .I pmon.out
        !            93: when the resulting object is executed.
        !            94: .PD
        !            95: .PP
        !            96: Other arguments
        !            97: are taken
        !            98: to be loader option arguments,
        !            99: perhaps libraries of
        !           100: .IR pc -compatible
        !           101: routines; see
        !           102: .IR ld (1).
        !           103: Certain options can also be controlled in comments within the program
        !           104: as described in the
        !           105: .I "Berkeley Pascal User's Manual."
        !           106: .SH FILES
        !           107: .TF /usr/lib/pc2.0strings
        !           108: .TP
        !           109: .B file.p
        !           110: pascal source files
        !           111: .TP
        !           112: .B /usr/lib/pc0
        !           113: compiler
        !           114: .TP
        !           115: .B /lib/f1
        !           116: code generator
        !           117: .TP
        !           118: .B /usr/lib/pc2
        !           119: runtime integrator (inline expander)
        !           120: .TP
        !           121: .B /lib/c2
        !           122: peephole optimizer
        !           123: .TP
        !           124: .B /usr/lib/pc3
        !           125: separate compilation consistency checker
        !           126: .TP
        !           127: .B /usr/lib/pc2.0strings
        !           128: text of the error messages
        !           129: .TP
        !           130: .B /usr/lib/how_pc
        !           131: basic usage explanation
        !           132: .TP
        !           133: .B /usr/lib/libpc.a
        !           134: intrinsic functions and I/O library
        !           135: .TP
        !           136: .B /usr/lib/libm.a
        !           137: math library
        !           138: .TP
        !           139: .B /lib/libc.a
        !           140: standard library, see
        !           141: .IR intro (3)
        !           142: .SH "SEE ALSO"
        !           143: .IR pascal (1),
        !           144: .IR pxp (A) ,
        !           145: .IR cc (1),
        !           146: .IR ld (1),
        !           147: .IR adb (1),
        !           148: .IR sdb (1),
        !           149: .IR prof (1)
        !           150: .br
        !           151: W. N. Joy, Susan L. Graham, C. B. Haley,
        !           152: `Berkeley Pascal User's Manual', in
        !           153: Unix Programmer's Manual, Seventh Edition, Virtual VAX-11 Version,
        !           154: 1980, Vol 2C
        !           155: (Berkeley).
        !           156: .SH DIAGNOSTICS
        !           157: See 
        !           158: .IR pascal (1)
        !           159: for an explanation of the error message format.
        !           160: Internal errors cause messages containing the word `SNARK'.
        !           161: .SH BUGS
        !           162: The keyword
        !           163: .B packed
        !           164: is recognized but has no effect.
        !           165: .br
        !           166: The binder is not as strict as it might be.
        !           167: .br
        !           168: The
        !           169: .B -z
        !           170: flag doesn't work for separately compiled files.
        !           171: .br
        !           172: Because
        !           173: .B -s
        !           174: is used by 
        !           175: .I pc,
        !           176: it can't be passed to the loader.

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