NAME¶
cxref-cpp - A modified C preprocessor to use with cxref.
SYNOPSIS¶
cxref-cpp ...
DESCRIPTION¶
To improve the output that is available for the source code for
cross-referencing a modified version of the GNU CPP v2.7.2 is supplied (named
cxref-cpp).
This modified C preprocessor allows for a finer control over some features of
the preprocessing that are not important for a compiler. In a standard
preprocessor, the preprocessor directives are intended for use only by the
preprocessor, so passing the information through is not important.
With cxref-cpp, there are some features that are different to the standard GNU
CPP:
- Compared to gcc versions earlier than version 2.8.0 there is an extra
option that will output the #include lines from the source file. In
version 2.8.0 and later this option is present.
- Comments trailing a #include or a #define are not preserved by all
versions of gcc even if the -C option is used. This is not important while
compiling, but is useful for documenting.
- The cxref-cpp program will take on the personality of the installed
version of gcc so that the gcc header files can be parsed. This means that
it includes the same default include directory paths and macro
definitions. The file that contains these definitions is called
cxref-cpp.defines and is installed by the cxref-cpp-configure program or
specified by the -cxref-cpp-defines command line option.
OPTIONS¶
The same as for gcc, apart from '-cxref-cpp-defines' described above.
SEE ALSO¶
cxref(1),
cxref-cpp-configure(1),
gcc(1)