cxref(1)                                                 cxref(1)



     NAME
          cxref - generate C program cross-reference

     SYNOPSIS
          cxref [-c] [-ofile] [-s] [-t] [-w[num]] files

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

          In addition to the -D, -I and -U flag options (which are
          identical to the corresponding flag options in cc(1)), the
          following flag options are interpreted by cxref:

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

          -w<num> Width flag option which formats output no wider than
          <num> (decimal) columns.  This flag option will default to
          80 if <num> is not specified or is less than 51.

          -o  file Direct output to named file .

          -s  Operate silently; does not print input file names.

          -t  Format listing for 80-column width.

     FILES
          /usr/bin/cxref

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

     SEE ALSO
          cc(1).

     DIAGNOSTICS
          Error messages are unusually cryptic, but usually mean that
          you can't compile these files, anyway.

     BUGS
          cxref considers a formal argument in a #define macro
          definition to be a declaration of that symbol.  For example,
          a program that #includes ctype.h, will contain many
          declarations of the variable c.






     Page 1                                        (last mod. 1/16/87)