12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576 |
- .TH CPP 6 "$Revision$"
- .ad
- .SH NAME
- cpp \- C Pre-Processor
- .SH SYNOPSIS
- .B ~em/lib.bin/cpp
- [\-options] [ file ]
- .SH DESCRIPTION
- .I Cpp
- reads a file, expands macros and include
- files, and writes an input file for the C compiler.
- All output is to standard output.
- .br
- The following options are supported.
- .IP -\fBI\fIdirectory\fR
- .br
- add this directory to the list of
- directories searched for #include "..." and #include <...>
- commands. Note that there is no space between the
- "-I" and the directory string. More than one -I command
- is permitted.
- .IP -\fBI\fR
- end the list of directories to be searched, and also do not look in
- default places.
- .IP -\fBD\fIname\fR=\fItext\fR
- .br
- define
- .I name
- as a macro with
- .I text
- as its replacement text.
- .IP -\fBD\fIname\fR
- the same as -\fBD\fIname\fR=1.
- .IP -\fBU\fIname\fR
- .br
- undefine the macro name
- .IR name .
- .IP -\fBC\fR
- leave comments in. By default, C-comments are deleted.
- .IP -\fBP\fR
- do not generate line directives
- .IP -\fBM\fIn\fR
- set maximum identifier length to
- .IR n .
- .IP -\fBd\fR[\fIfile\fR]
- .br
- if \fIfile\fR is not given, do not preprocess, but instead generate a list
- of makefile dependencies and write them to the standard output.
- If \fIfile\fP is given, generate preprocessor output on standard output,
- and generate the list of makefile dependencies on file \fIfile\fP.
- .IP -\fBA\fR[\fIfile\fR]
- identical to the -d option.
- .IP -\fBi\fR
- when generating makefile dependencies, do not include files from
- /usr/include.
- .IP -\fBm\fR
- when generating makefile dependencies, generate them in the following format:
- .RS
- .IP "file.o: file1.h"
- .RE
- .IP ""
- where "file.o" is derived from the source file name. Normally, only a list
- of files included is generated.
- .IP -\fBundef\fR
- .br
- this flag is silently ignored, for compatibility with other preprocessors.
- .PP
- The following names are always available unless undefined:
- .IP __FILE__
- The input (or #include) file being compiled
- (as a quoted string).
- .IP __LINE__
- The line number being compiled.
- .IP __DATE__
- The date and time of compilation as
- a Unix ctime quoted string (the trailing newline is removed).
|