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)

                                           May 9, 2004                               cxref-cpp(1)