cxref(1)                                                 cxref(1)



     NAME
          cxref - generate C program cross-reference

     SYNOPSIS
          cxref [-c] [-o file] [-s] [-t] [-w[num]] file...

     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 information from #define statements 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 combina-
          tion.  Each symbol contains an asterisk (*) before the de-
          claring 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        Prints 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   Directs output to named file.

          -s        Operates silently; does not print input filenames.

          -t        Formats listing for 80-column width.

     FILES
          /usr/bin/cxref
          /usr/lib/xpass input file parser
          /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 defini-
          tion to be a declaration of that symbol.  For example, a
          program that contains the line

             #include <ctype.h>



     April, 1990                                                     1

     cxref(1)                                                 cxref(1)



          will contain many declarations of the variable c.

          When using the -o option, the space between the -o and the
          file argument is critical.  If you omit the space, as in

             cxref -otest test.c

          then the input file test.c will be destroyed.















































     2                                                     April, 1990