xref: /plan9-contrib/sys/man/1/cpp (revision 219b2ee8daee37f4aad58d63f21287faa8e4ffdc)
CPP 1
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:

-D name\^

0

-D name=def\^

-I dir\^ Same as in 2c (1).

-M Generate no output except a list of include files in a form suitable for specifying dependencies to mk (1). 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 .L "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
.TF /objtype/include

/sys/include directory for machine-independent include files

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

SOURCE
/sys/src/cmd/cpp
SEE ALSO
2c (1)