cxref-cpp(1)                                         cxref-cpp(1)



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  com-
              piling, 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)