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