Return to cpp.8 CVS log

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

Annotation of researchv10dc/man/man8/cpp.8, revision 1.1.1.1

1.1       root        1: .TH CPP 8
                      2: .CT 1 prog_c
                      3: .SH NAME
                      4: cpp \- C language preprocessor
                      5: .SH SYNOPSIS
                      6: .B /lib/cpp
                      7: [
                      8: .I option ...
                      9: ]
                     10: [
                     11: .I ifile
                     12: [
                     13: .I ofile
                     14: ]
                     15: ]
                     16: .SH DESCRIPTION
                     17: .I Cpp\^
                     18: interprets preprocessor directives
                     19: and does macro substitution
                     20: for
                     21: .IR cc (1)
                     22: and other compilers.
                     23: The input
                     24: .I ifile
                     25: and output
                     26: .I ofile
                     27: default to standard input and standard output respectively.
                     28: .PP
                     29: The options are:
                     30: .TP
                     31: .B -P
                     32: Do not place line number markings in output.
                     33: .TP
                     34: .B -C
                     35: Do not remove comments.
                     36: .TP
                     37: .BI -U name\^
                     38: .PD 0
                     39: .TP
                     40: .BI -D name\^
                     41: .TP
                     42: .BI -D name=def\^
                     43: .TP
                     44: .BI -I dir\^
                     45: Same as in
                     46: .IR cc (1).
                     47: .B -U
                     48: overrides
                     49: .BR -D .
                     50: .PD
                     51: .TP
                     52: .B -H
                     53: Report all included files on standard error file,.
                     54: .TP
                     55: .B -M
                     56: Attach modification date to file names in line number
                     57: directives thus:
                     58: .IB file @ modtime,
                     59: where modtime is the integer number of seconds since the epoch.
                     60: .TP
                     61: .B -T
                     62: Truncate preprocessor symbols to eight characters.
                     63: .TP
                     64: .BI -Y dir
                     65: Use
                     66: .I dir
                     67: instead of
                     68: .F /usr/include
                     69: as the last resort in searching for include files.
                     70: .PP
                     71: The output file contains processed text sprinkled
                     72: with lines that show the original input line numbering:
                     73: .IP
                     74: .B #
                     75: .I linenumber
                     76: .L
                     77: "\fIifile\fP"
                     78: .PP
                     79: The input language is as described in the reference,
                     80: with a few additions:
                     81: .PP
                     82: The
                     83: .B #
                     84: .I linenumber
                     85: marks placed in the output are accepted as an alternative
                     86: to the official
                     87: .B #line
                     88: directive.
                     89: .PP
                     90: These symbols are predefined in various implementations:
                     91: .IP
                     92: .EX
                     93: ibm gcos os tss unix
                     94: interdata pdp11 u370 u3b u3b5 vax
                     95: RES RT
                     96: lint
                     97: .EE
                     98: .PP
                     99: Preprocessor formal parameters are recognized within
                    100: quoted strings in the replacement text.
                    101: .PP
                    102: When comments are removed they are replaced by null strings;
                    103: this unofficial feature makes it possible to construct
                    104: identifiers by concatenation.
                    105: .SH FILES
                    106: .TF /usr/include
                    107: .TP
                    108: .F /usr/include
                    109: standard directory for include files
                    110: .SH SEE ALSO
                    111: B. W. Kernighan and D. M. Ritchie,
                    112: .I The C Programming Language,
                    113: Prentice-Hall,
                    114: 1988

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