

XREF (1)                     1/1/79                      XREF (1)




NAME
   xref - make a cross reference of symbols

SYNOPSIS
   xref [-f] [file] ...

DESCRIPTION
   Xref produces a cross-reference list of the symbols in each of
   the  named files on the standard output. Each symbol is listed
   followed by the numbers of the lines in which it  appears.  If
   no  files  are given, or the file "-" is specified, xref reads
   the standard input.

   A  symbol  is  defined  as  a  string  of   letters,   digits,
   underlines,  or  periods  that  begins  with a letter. Symbols
   exceeding an internal  limit  are  truncated.  This  limit  is
   determined by the MAXTOK definition in the source code, and is
   currently set to 15.

   Normally,   xref  treats  upper-  and  lower-case  letters  as
   different characters.  The -f option causes all letters to  be
   folded to lower-case.

DIAGNOSTICS
   out of storage
      The  file  contains  too  many symbols or references to fit
      within the current limitations of xref.  The  size  of  the
      buffer is determined by the MAXBUF definition in the source
      code.

AUTHORS
   David Hanson and friends (U. of Arizona)

BUGS/DEFICIENCIES
   There  should be a means of suppressing "junk" symbols such as
   "the", "a", etc.
















