|
|
1.1 root 1: .TH MCC 9.1
2: .SH NAME
3: mcc \- MC68000 C compiler
4: .SH SYNOPSIS
5: .B mcc
6: [
7: .I option
8: ]
9: ... file ...
10: .SH DESCRIPTION
11: .I Mcc
12: is the C compiler for the Motorola 68000.
13: Its default action is to compile programs to run under the
14: .IR mpx (1)
15: environment on a Blit terminal.
16: .PP
17: .I Mcc
18: accepts several types of arguments:
19: .PP
20: Arguments whose names end with `.c' are taken to be
21: C source programs; they are compiled, and
22: each object program is left on the file
23: whose name is that of the source with `.o' substituted
24: for `.c'.
25: The `.o' file is normally deleted, however, if a single
26: C program is compiled and loaded all at one go.
27: .PP
28: In the same way,
29: arguments whose names end with `.s' are taken to be assembly source programs
30: and are assembled, producing a `.o' file.
31: .PP
32: Programs using floating-point must be compiled with the
33: .B \-lf
34: load-time option
35: to load the floating-point support package.
36: .PP
37: The following options are interpreted by
38: .IR mcc .
39: Load time options, described under
40: .IR mld (1),
41: are passed to
42: .I mld.
43: .TP 8
44: .B \-c
45: Suppress the loading phase of the compilation; force
46: an object file to be produced even if only one program is compiled.
47: .TP
48: .B \-j
49: Compile the named programs, and load and link them for running stand-alone
50: on a Blit terminal.
51: .TP
52: .B \-m
53: Compile the named programs for ordinary (non-Blit) environments.
54: .TP
55: .B \-w
56: Suppress warning diagnostics.
57: .TP
58: .SM
59: .B \-O
60: Invoke an
61: object-code improver.
62: .TP
63: .SM
64: .B \-S
65: Compile the named C programs, and leave the
66: assembler-language output on corresponding files suffixed `.s'.
67: .TP
68: .SM
69: .B \-E
70: Run only the macro preprocessor
71: on the named C programs, and send the result to the
72: standard output.
73: .TP
74: .SM
75: .B \-C
76: prevent the macro preprocessor from eliding comments.
77: .TP
78: .BI \-o " output"
79: Name the final output file
80: .IR output .
81: If this option is used the file `a.out' will be left undisturbed.
82: .TP
83: .SM
84: .BI \-D name=def
85: .br
86: .ns
87: .TP
88: .SM
89: .BI \-D \*Sname
90: Define the
91: .I name
92: to the preprocessor,
93: as if by
94: `#define'.
95: If no definition is given, the name is defined as "1".
96: The symbol
97: .I mc68000
98: is predefined.
99: .TP
100: .SM
101: .BI \-U \*Sname
102: Remove any initial definition of
103: .IR name .
104: .TP
105: .SM
106: .BI \-I \*Sdir
107: `#include' files
108: whose names do not begin with `/' are always
109: sought first in the directory
110: of the
111: .I file
112: argument,
113: then in directories named in
114: .B \-I
115: options,
116: then in directories on a standard list.
117: .TP
118: .SM
119: .BI \-B \*Sstring
120: Find substitute compiler passes in the files named
121: .I string
122: with the suffixes cpp, ccom and c2.
123: If
124: .I string
125: is empty, use a standard backup version.
126: .TP
127: .BR \-t [ p012 ]
128: Find only the designated compiler passes in the
129: files whose names are constructed by a
130: .B \-B
131: option.
132: In the absence of a
133: .B \-B
134: option, the
135: .I string
136: is taken to be `/usr/c/'.
137: .PP
138: Other arguments
139: are taken
140: to be either loader option arguments, or C-compatible
141: object programs, typically produced by an earlier
142: .I mcc
143: run,
144: or perhaps libraries of C-compatible routines.
145: These programs, together with the results of any
146: compilations specified, are loaded (in the order
147: given) to produce an executable program with name
148: .B a.out.
149: .SH FILES
150: .ta \w'/usr/jerq/lib/notsolow.o 'u
151: file.c input file
152: .br
153: file.o object file
154: .br
155: a.out loaded output
156: .br
157: /tmp/ctm? temporary
158: .br
159: /lib/cpp preprocessor
160: .br
161: /usr/jerq/lib/ccom compiler
162: .br
163: /usr/jerq/lib/occom backup compiler
164: .br
165: /usr/jerq/lib/mc2 optimizer
166: .br
167: /usr/jerq/lib/l.o runtime startoff for
168: .B \-j
169: .br
170: /usr/jerq/lib/notsolow.o runtime startoff for
171: .B \-m
172: .br
173: /usr/jerq/lib/libc.a standard library
174: .br
175: /usr/jerq/lib/libf.a floating-point library
176: .br
177: /usr/jerq/lib/libj.a graphics library (used in
178: .BR \-lj ).
179: .br
180: /usr/jerq/lib/libsys.a system and I/O library (used in
181: .BR \-lj ).
182: .br
183: /usr/jerq/include standard directory for `#include' files
184: .SH "OTHER PROGRAMS"
185: The usual array of associated object-code manipulating programs exists,
186: with specifications identical to the usual Unix programs, and with
187: names prefixed with an `m.'
188: These programs include:
189: .ta \w'mlorder 'u
190: .br
191: mas assembler, see
192: .IR as (1)
193: .br
194: mlorder order library,
195: .IR lorder (1)
196: (there is no mranlib)
197: .br
198: mnm name list, see
199: .IR nm (1)
200: .br
201: msize object code size,
202: .IR size (1)
203: .br
204: mstrip strip symbol table,
205: .IR strip (1)
206: .fi
207: .SH "SEE ALSO"
208: B. W. Kernighan and D. M. Ritchie,
209: .I The C Programming Language,
210: Prentice-Hall,
211: 1978
212: .br
213: B. W. Kernighan,
214: .I
215: Programming in C\(ema tutorial
216: .br
217: D. M. Ritchie,
218: .I
219: C Reference Manual
220: .br
221: .IR mld (1),
222: .IR cc (1)
223: .SH DIAGNOSTICS
224: The diagnostics produced by C itself are intended to be
225: self-explanatory.
226: Occasional messages may be produced by the assembler
227: or loader.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.