CXREF(1)                                                 CXREF(1)



     NAME
          cxref - generate C program cross-reference

     SYNOPSIS
          cxref [ options ] files

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

          In addition to the -D, -I and -U options [which are
          interpreted just as they are by cc(1) and cpp(1)], the
          following options are interpreted by cxref:

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

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

          -o file Direct output to file.

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

          -t      Format listing for 80-column width.

     FILES
          LLIBDIR         usually /usr/lib

          LLIBDIR/xcpp    special version of the C preprocessor.

     SEE ALSO
          cc(1), cpp(1).

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

     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.

     ORIGIN
          AT&T V.3



     Page 1                                        (last mod. 8/20/87)