Annotation of researchv10dc/man/mana/mcc.9, revision 1.1.1.1

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.

unix.superglobalmegacorp.com

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