CXREF(CP)                XENIX System V                 CXREF(CP)



     Name
          cxref - Generates C program cross-reference.

     Syntax
          cxref [ options ] file ...

     Description
          cxref analyzes a collection of C files and attempts to build
          a cross-reference table.  cxref uses a special version of
          cpp to include information defined by #define in its symbol
          table.  It produces a listing on the standard output of all
          symbols (auto, static, and global) for each separate file,
          or with the -c option for the combined files.  Each symbol
          contains an asterisk (*) before the declaring reference.

          In addition to the -D, -I and -U options (which are
          identical to their interpretation by cc(CP)), the following
          options are interpreted by cxref:

          -c          Prints a combined cross-reference of all input
                      files.

          -w<num>     Formats output no wider than <num> (decimal)
                      columns.  The default is 80 if <num> is not
                      specified or is less than 51.

          -o file     Directs output to named file.

          -s          Operates silently; does not print input
                      filenames.

          -t          Formats listing for 80-column width.

     Files
          /usr/lib/xcpp    special version of C-preprocessor.

     See Also
          cc(CP)

     Diagnostics
          Error messages are cryptic, but usually mean that you cannot
          compile these files.

     Notes
          cxref considers a formal argument in a #define macro
          definition to be a declaration of that symbol. For example,
          a program that contains ``#include ctype.h '' will have many
          declarations of the variable c.







     Page 1                                           (printed 8/7/87)