cxref(1)                   DG/UX 4.30                    cxref(1)



     NAME
          cxref - generate C program cross-reference

     SYNOPSIS
          cxref [ options ] files

     DESCRIPTION
          Cxref analyzes a collection of C files and tries 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.

          Options, in addition to the -D, -I and -U options (which are
          identical to their interpretation by cc(1)), are:

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

          -w<num>   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 named file.

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

          -t        Format listing for 80-column width.

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

     SEE ALSO
          cc(1).

     DIAGNOSTICS
          Error messages are cryptic, but usually mean that you cannot
          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.









     Licensed material--property of copyright holder(s)         Page 1