1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495 |
- .TH CPP.ANSI 6 "$Revision$"
- .ad
- .SH NAME
- cpp.ansi \- ANSI C Pre-Processor
- .SH SYNOPSIS
- .B ~em/lib.bin/cpp.ansi
- [\-options] [ file ]
- .SH DESCRIPTION
- .I Cpp.ansi
- 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
- .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. They cannot be the subject of a
- -U command line option or a #undef directive.
- .RS
- .IP __STDC__
- A decimal constant 1, indicating that this is an ANSI C conforming
- implementation.
- .IP __FILE__
- The input (or #include) file being compiled
- (as a quoted string).
- .IP __LINE__
- The line number being compiled.
- .IP __DATE__
- The date of translation of the source file. This is a string
- literal of the form "\fBMmm dd yyyy\fP".
- .IP __TIME__
- The time of translation of the source file. This is a string
- literal of the form "\fBhh:mm:ss\fP".
- .RE
- .SH BUGS
- The output may contain extra spaces, this prevents unintended
- pasting of tokens.
- .SH "SEE ALSO"
- L. Rosler,
- .I
- Draft Proposed Standard - Programming Language C,
- .R
- ANSI X3J11 Language Subcommittee
|