NAME

cpp − C language preprocessor

SYNOPSIS

­cpp [ ­option ...  ] [ ­ifile [ ­ofile ] ]

DESCRIPTION

­Cpp interprets ANSI C preprocessor directives and does macro substitution.  The input ­ifile and output ­ofile default to standard input and standard output respectively. 

The options are:

-Uname

-Dname

-Dname=def

-Idir Same as in 2c(1).

­-M Generate no output except a list of include files.  Use twice to list files in angle brackets. 

­-N Turn off default include directories.  All must be specified with -I.  Without this option, ­/$objtype/include and ­/sys/include are used as the last two searched directories for include directives, where ­$objtype is read from the environment. 

­-V Print extra debugging information. 

­-+ Understand C++ comments. 

The output file contains processed text sprinkled with lines that show the original input line numbering:

­#line ­linenumber "ifile"

The input language is as described in the ANSI C standard.  The C compilers do not use ­cpp; they contain their own simple but adequate preprocessor, so ­cpp is usually superfluous. 

FILES

­/sys/include directory for machine-independent include files

­/$objtype/include
directory for machine-dependent include files

SEE ALSO

2c(1)

Plan 9  —  January 03, 1993