summaryrefslogtreecommitdiff
path: root/static/unix-v10/man9/mcc.9
diff options
context:
space:
mode:
Diffstat (limited to 'static/unix-v10/man9/mcc.9')
-rw-r--r--static/unix-v10/man9/mcc.9227
1 files changed, 227 insertions, 0 deletions
diff --git a/static/unix-v10/man9/mcc.9 b/static/unix-v10/man9/mcc.9
new file mode 100644
index 00000000..115741bb
--- /dev/null
+++ b/static/unix-v10/man9/mcc.9
@@ -0,0 +1,227 @@
+.TH MCC 9.1
+.SH NAME
+mcc \- MC68000 C compiler
+.SH SYNOPSIS
+.B mcc
+[
+.I option
+]
+... file ...
+.SH DESCRIPTION
+.I Mcc
+is the C compiler for the Motorola 68000.
+Its default action is to compile programs to run under the
+.IR mpx (1)
+environment on a Blit terminal.
+.PP
+.I Mcc
+accepts several types of arguments:
+.PP
+Arguments whose names end with `.c' are taken to be
+C source programs; they are compiled, and
+each object program is left on the file
+whose name is that of the source with `.o' substituted
+for `.c'.
+The `.o' file is normally deleted, however, if a single
+C program is compiled and loaded all at one go.
+.PP
+In the same way,
+arguments whose names end with `.s' are taken to be assembly source programs
+and are assembled, producing a `.o' file.
+.PP
+Programs using floating-point must be compiled with the
+.B \-lf
+load-time option
+to load the floating-point support package.
+.PP
+The following options are interpreted by
+.IR mcc .
+Load time options, described under
+.IR mld (1),
+are passed to
+.I mld.
+.TP 8
+.B \-c
+Suppress the loading phase of the compilation; force
+an object file to be produced even if only one program is compiled.
+.TP
+.B \-j
+Compile the named programs, and load and link them for running stand-alone
+on a Blit terminal.
+.TP
+.B \-m
+Compile the named programs for ordinary (non-Blit) environments.
+.TP
+.B \-w
+Suppress warning diagnostics.
+.TP
+.SM
+.B \-O
+Invoke an
+object-code improver.
+.TP
+.SM
+.B \-S
+Compile the named C programs, and leave the
+assembler-language output on corresponding files suffixed `.s'.
+.TP
+.SM
+.B \-E
+Run only the macro preprocessor
+on the named C programs, and send the result to the
+standard output.
+.TP
+.SM
+.B \-C
+prevent the macro preprocessor from eliding comments.
+.TP
+.BI \-o " output"
+Name the final output file
+.IR output .
+If this option is used the file `a.out' will be left undisturbed.
+.TP
+.SM
+.BI \-D name=def
+.br
+.ns
+.TP
+.SM
+.BI \-D \*Sname
+Define the
+.I name
+to the preprocessor,
+as if by
+`#define'.
+If no definition is given, the name is defined as "1".
+The symbol
+.I mc68000
+is predefined.
+.TP
+.SM
+.BI \-U \*Sname
+Remove any initial definition of
+.IR name .
+.TP
+.SM
+.BI \-I \*Sdir
+`#include' files
+whose names do not begin with `/' are always
+sought first in the directory
+of the
+.I file
+argument,
+then in directories named in
+.B \-I
+options,
+then in directories on a standard list.
+.TP
+.SM
+.BI \-B \*Sstring
+Find substitute compiler passes in the files named
+.I string
+with the suffixes cpp, ccom and c2.
+If
+.I string
+is empty, use a standard backup version.
+.TP
+.BR \-t [ p012 ]
+Find only the designated compiler passes in the
+files whose names are constructed by a
+.B \-B
+option.
+In the absence of a
+.B \-B
+option, the
+.I string
+is taken to be `/usr/c/'.
+.PP
+Other arguments
+are taken
+to be either loader option arguments, or C-compatible
+object programs, typically produced by an earlier
+.I mcc
+run,
+or perhaps libraries of C-compatible routines.
+These programs, together with the results of any
+compilations specified, are loaded (in the order
+given) to produce an executable program with name
+.B a.out.
+.SH FILES
+.ta \w'/usr/jerq/lib/notsolow.o 'u
+file.c input file
+.br
+file.o object file
+.br
+a.out loaded output
+.br
+/tmp/ctm? temporary
+.br
+/lib/cpp preprocessor
+.br
+/usr/jerq/lib/ccom compiler
+.br
+/usr/jerq/lib/occom backup compiler
+.br
+/usr/jerq/lib/mc2 optimizer
+.br
+/usr/jerq/lib/l.o runtime startoff for
+.B \-j
+.br
+/usr/jerq/lib/notsolow.o runtime startoff for
+.B \-m
+.br
+/usr/jerq/lib/libc.a standard library
+.br
+/usr/jerq/lib/libf.a floating-point library
+.br
+/usr/jerq/lib/libj.a graphics library (used in
+.BR \-lj ).
+.br
+/usr/jerq/lib/libsys.a system and I/O library (used in
+.BR \-lj ).
+.br
+/usr/jerq/include standard directory for `#include' files
+.SH "OTHER PROGRAMS"
+The usual array of associated object-code manipulating programs exists,
+with specifications identical to the usual Unix programs, and with
+names prefixed with an `m.'
+These programs include:
+.ta \w'mlorder 'u
+.br
+mas assembler, see
+.IR as (1)
+.br
+mlorder order library,
+.IR lorder (1)
+(there is no mranlib)
+.br
+mnm name list, see
+.IR nm (1)
+.br
+msize object code size,
+.IR size (1)
+.br
+mstrip strip symbol table,
+.IR strip (1)
+.fi
+.SH "SEE ALSO"
+B. W. Kernighan and D. M. Ritchie,
+.I The C Programming Language,
+Prentice-Hall,
+1978
+.br
+B. W. Kernighan,
+.I
+Programming in C\(ema tutorial
+.br
+D. M. Ritchie,
+.I
+C Reference Manual
+.br
+.IR mld (1),
+.IR cc (1)
+.SH DIAGNOSTICS
+The diagnostics produced by C itself are intended to be
+self-explanatory.
+Occasional messages may be produced by the assembler
+or loader.