CXREF(1-SysV)       RISC/os Reference Manual        CXREF(1-SysV)



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 refer-
     ence.

     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.

ERRORS
     cxref considers a formal argument in a #define macro defini-
     tion to be a declaration of that symbol. For example, a pro-
     gram that #includes ctype.h, will contain many declarations
     of the variable c.



                         Printed 1/15/91                   Page 1