packages icon



 cxref-cpp(1)                                                   cxref-cpp(1)
                                 May 9, 2004



 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)








                                    - 1 -       Formatted:  January 21, 2021