Return to cpp CVS log

Up to [Plan 9 NeXT] / lucent / sys / man / 1

Annotation of lucent/sys/man/1/cpp, revision 1.1.1.1

1.1       root        1: .TH CPP 1
                      2: .SH NAME
                      3: cpp \- C language preprocessor
                      4: .SH SYNOPSIS
                      5: .B cpp
                      6: [
                      7: .I option ...
                      8: ]
                      9: [
                     10: .I ifile
                     11: [
                     12: .I ofile
                     13: ]
                     14: ]
                     15: .SH DESCRIPTION
                     16: .I Cpp\^
                     17: interprets ANSI C preprocessor directives
                     18: and does macro substitution.
                     19: The input
                     20: .I ifile
                     21: and output
                     22: .I ofile
                     23: default to standard input and standard output respectively.
                     24: .PP
                     25: The options are:
                     26: .TP
                     27: .BI -D name\^
                     28: .PD 0
                     29: .TP
                     30: .BI -D name=def\^
                     31: .TP
                     32: .BI -I dir\^
                     33: Same as in
                     34: .IR 2c (1).
                     35: .PD
                     36: .TP
                     37: .B -M
                     38: Generate no output except a list of include files
                     39: in a form suitable for specifying dependencies to
                     40: .IR mk (1).
                     41: Use twice to list files in angle brackets.
                     42: .TP
                     43: .B -N
                     44: Turn off default include directories.  All must be
                     45: specified with
                     46: .BR -I .
                     47: Without this option,
                     48: .B /$objtype/include
                     49: and
                     50: .B /sys/include
                     51: are used as the last two searched directories for include directives,
                     52: where
                     53: .B $objtype
                     54: is read from the environment.
                     55: .TP
                     56: .B -V
                     57: Print extra debugging information.
                     58: .TP
                     59: .B -+
                     60: Understand C++ comments.
                     61: .PD
                     62: .PP
                     63: The output file contains processed text sprinkled
                     64: with lines that show the original input line numbering:
                     65: .IP
                     66: .B #line
                     67: .I linenumber
                     68: .L
                     69: "\fIifile\fP"
                     70: .PP
                     71: The input language is as described in the ANSI C standard.
                     72: The C compilers do not use
                     73: .IR cpp ;
                     74: they contain their own simple but adequate preprocessor, so
                     75: .I cpp
                     76: is usually superfluous.
                     77: .SH FILES
                     78: .TF /objtype/include
                     79: .TP
                     80: .B /sys/include
                     81: directory for machine-independent include files
                     82: .TP
                     83: .B /$objtype/include
                     84: directory for machine-dependent include files
                     85: .SH SOURCE
                     86: .B /sys/src/cmd/cpp
                     87: .SH SEE ALSO
                     88: .IR 2c (1)

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