Return to mcc.9 CVS log

Up to [Research Unix] / researchv10dc / man / mana

Annotation of researchv10dc/man/mana/mcc.9, revision 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.

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