Annotation of researchv10dc/man/mana/pc.1, revision 1.1.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.

unix.superglobalmegacorp.com

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