BSD 3 development

[unix-history] / usr / man / man1 / cc.1

diff --git a/usr/man/man1/cc.1 b/usr/man/man1/cc.1
index bd63e70..fca4ecb 100644 (file)
--- a/usr/man/man1/cc.1
+++ b/usr/man/man1/cc.1
@@ -1,12 +1,9 @@
-.TH CC 1  PDP11
+.TH CC 1 "VAX/11"

 .SH NAME
 .SH NAME

-cc, pcc \- C compiler
+cc \- C compiler

 .SH SYNOPSIS
 .B cc
 [ option ] ... file ...
 .SH SYNOPSIS
 .B cc
 [ option ] ... file ...

-.PP
-.B pcc
-[ option ] ... file ...

 .SH DESCRIPTION
 .I Cc
 is the UNIX C compiler.
 .SH DESCRIPTION
 .I Cc
 is the UNIX C compiler.


@@ -34,6 +31,26 @@ for load-time options.
 Suppress the loading phase of the compilation, and force
 an object file to be produced even if only one program is compiled.
 .TP
 Suppress the loading phase of the compilation, and force
 an object file to be produced even if only one program is compiled.
 .TP

+.B \-g
+Have the compiler produce additional symbol table information
+for 
+.IR sdb (1).
+Also pass the
+.B \-lg
+flag to
+.IR ld (1).
+.TP
+.B \-w
+Suppress warning diagnostics.
+.TP
+.B \-z
+Create load-on-demand format output (an
+.IR ld (1)
+flag);
+this is important to specify when loading certain very large programs.
+See
+.IR ld (1).
+.TP

 .B \-p
 Arrange for the compiler to produce code
 which counts the number of times each routine is called;
 .B \-p
 Arrange for the compiler to produce code
 which counts the number of times each routine is called;


@@ -47,17 +64,10 @@ An execution profile can then be generated by
 use of
 .IR  prof (1).
 .TP
 use of
 .IR  prof (1).
 .TP

-.B \-f
-In systems without hardware floating-point,
-use a version of the C compiler which handles floating-point
-constants and
-loads the object program with the floating-point interpreter.
-Do not use if the hardware is present.
-.TP

 .SM
 .B \-O
 Invoke an
 .SM
 .B \-O
 Invoke an

-object-code optimizer.
+object-code improver.

 .TP
 .SM
 .B \-S
 .TP
 .SM
 .B \-S


@@ -65,19 +75,10 @@ Compile the named C programs, and leave the
 assembler-language output on corresponding files suffixed `.s'.
 .TP
 .SM
 assembler-language output on corresponding files suffixed `.s'.
 .TP
 .SM

-.B \-P
-Run only the macro preprocessor and place the result for
-each `.c' file in a corresponding `.i' file
-and has no `#' lines in it.
-.TP
-.SM

 .B \-E
 Run only the macro preprocessor
 .B \-E
 Run only the macro preprocessor

-and send the result to the
+on the named C programs, and send the result to the

 standard output.
 standard output.

-The output is intended for compiler debugging; it 
-is unacceptable as input to
-.IR cc .

 .TP
 .BI \-o " output"
 Name the final output file
 .TP
 .BI \-o " output"
 Name the final output file


@@ -95,7 +96,7 @@ Define the
 to the preprocessor,
 as if by
 `#define'.
 to the preprocessor,
 as if by
 `#define'.

-If no definition is given, the name is defined as 1.
+If no definition is given, the name is defined as "1".

 .TP
 .SM
 .BI \-U \*Sname
 .TP
 .SM
 .BI \-U \*Sname


@@ -119,7 +120,7 @@ then in directories on a standard list.
 .BI \-B \*Sstring
 Find substitute compiler passes in the files named
 .I string
 .BI \-B \*Sstring
 Find substitute compiler passes in the files named
 .I string

-with the suffixes cpp, c0, c1 and c2.
+with the suffixes cpp, ccom and c2.

 If 
 .I string 
 is empty, use a standard backup version.
 If 
 .I string 
 is empty, use a standard backup version.


@@ -146,92 +147,50 @@ 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.
 compilations specified, are loaded (in the order
 given) to produce an executable program with name
 .B a.out.

-.PP
-The major purpose of the `portable C compiler',
-.I pcc,
-is to serve as a model
-on which to base other compilers.
-.I Pcc
-does not support options
-.BR \-f ,
-.BR \-E ,
-.BR \-B ,
-and
-.BR \-t .
-It provides, in addition to the language of
-.I cc,
-unsigned char type data and initialized bit fields.

 .SH FILES
 .SH FILES

-.ta \w'/usr/c/oc[102]  'u
+.ta \w'/usr/c/occom  'u

 file.c input file
 .br
 file.o object file
 .br
 a.out  loaded output
 .br
 file.c input file
 .br
 file.o object file
 .br
 a.out  loaded output
 .br

-/tmp/ctm?      temporaries for
-.I cc
+/tmp/ctm?      temporary

 .br
 /lib/cpp       preprocessor
 .br
 .br
 /lib/cpp       preprocessor
 .br

-/lib/c[01]     compiler for
-.I cc
+/lib/ccom      compiler

 .br
 .br

-/usr/c/oc[012] backup compiler for
-.I cc
+/usr/c/occom   backup compiler

 .br
 /usr/c/ocpp    backup preprocessor
 .br
 .br
 /usr/c/ocpp    backup preprocessor
 .br

-/lib/fc[01]    floating-point compiler
-.br

 /lib/c2        optional optimizer
 .br
 /lib/crt0.o    runtime startoff
 .br
 /lib/mcrt0.o   startoff for profiling
 .br
 /lib/c2        optional optimizer
 .br
 /lib/crt0.o    runtime startoff
 .br
 /lib/mcrt0.o   startoff for profiling
 .br

-/lib/fcrt0.o   startoff for floating-point interpretation
-.br
-/lib/libc.a    standard library, see
-.IR intro (3)
+/lib/lib[ac].a standard libraries, see (3)

 .br
 /usr/include   standard directory for `#include' files
 .br
 /usr/include   standard directory for `#include' files

-.br
-/tmp/pc*       temporaries for
-.I pcc
-.br
-/usr/lib/ccom  compiler for
-.I pcc

 .SH "SEE ALSO"
 B. W. Kernighan and D. M. Ritchie,
 .I The C Programming Language,
 Prentice-Hall,
 1978
 .br
 .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
 D. M. Ritchie,
 .I
 C Reference Manual
 .br

-monitor(3), prof(1), adb(1), ld(1)
+monitor(3), prof(1), adb(1), ld(1), sdb(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.
 .SH DIAGNOSTICS
 The diagnostics produced by C itself are intended to be
 self-explanatory.
 Occasional messages may be produced by the assembler
 or loader.

-Of these, the most mystifying are from the assembler,
-.IR as (1),
-in particular `m', which means
-a multiply-defined external symbol (function
-or data).
-.SH BUGS
-.I Pcc
-is little tried on the PDP11; specialized
-code generated for that machine has not been
-well shaken down.
-The
-.B \-O
-optimizer was designed to work with
-.IR cc ;
-its use with
-.I pcc
-is suspect.