CXREF(1)             INTERACTIVE UNIX System             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.  The cxref com-
               mand 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 combina-
               tion.  Each symbol contains an asterisk (*) before the
               declaring reference.

               In addition to the -D, -I, and -U options [which are inter-
               preted 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
               The cxref command 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.






          Rev. C Software Development Set                            Page 1