7.0;crefs (cross_reference_symbols), revision 7.0, 81/07/01
CREFS (CROSS_REFERENCE_SYMBOLS) -- Cross-reference symbols in a file.
usage: CREFS [-F] [pathname ...]
FORMAT
CREFS [-F] [pathname ...]
CREFS produces a cross-referenced list of the symbols in each of the named
files, and writes each list to standard output. A symbol is a string of
letters, digits, underscores, and dollar signs and must begin with a letter.
The list contains every symbol in the file in alphabetical order, followed by
the numbers of the lines in which the symbol appears.
Symbols of more than 32 characters are truncated.
ARGUMENTS
pathname
(optional) Specify input file. Multiple pathnames and wildcarding are
permitted: separate names with blanks.
Default if omitted: read text from standard input.
OPTIONS
If the option is not specified, CREFS treats uppercase and lowercase letters
as different characters, and places uppercase letters before lowercase letters
in the alphabetical sort.
-F Treat all input text as lowercase while cross-referencing.
-K key_file Only the words listed in 'key_file' are cross-referenced.
These words must be listed one per line.
This command uses the command line parser, and so also accepts the standard
command options listed in HELP CL.
EXAMPLES
To find all occurrences of certain variables in the program "cycle," type:
$ crefs cycle
CREFS can also be used in conjunction with other commands to produce more
refined results. For instance:
$ crefs cycle | tee cycle.all | fpat wheel spoke axle >cycle.some
The output file "cycle.all" contains a list of all the symbols in the program,
with references to the line containing them. The output file "cycle.some"
contains only the lines with references to the three variables named: wheel,
spoke, and axle.