6/14/1972 CREF (VI)
NAME cref -- make cross reference listing
SYNOPSIS cref [ -soi ] name1 ...
DESCRIPTION CREF makes a cross reference listing of files in
assembler format (see AS(I)). The files named as
arguments in the command line are searched for
symbols (defined as a succession of alphabetics,
numerics, '.', or '_', beginning with an alpha-
betic, '.', or '_').
The output report is in four columns:
(1) (2) (3) (4)
symbol file see text as it appears in file
below
The third column contains the line number in the
file by default; the -s option will cause the
most recent name symbol to appear there instead.
CREF uses either an ignore file or an only file.
If the -i option is given, it will take the next
file name to be an ignore file; if the -o option
is given, the next file name will be taken as an
only file. Either ignore or only files must be
made by chash (q.v.). If an ignore file is
given, all the symbols in the file will be ig-
nored in columns (1) and (3) of the output. If
an only file is given, only symbols appearing in
the file will appear in column (1), but column
(3) will still contain the most recent name en-
countered. Only one of the options -i or -o may
be used. The default setting is -i; all symbols
predefined in the assembler are ignored, except
system call names, which are collected.
FILES Files t.0, t.1, t.2, t.3 are created (i.e. DE-
STROYED) in the working directory of anyone using
cref. This nuisance will be repaired soon. The
output is left in file s.out in the working di-
rectory.
/usr/lem/s.tab is the default ignore file.
SEE ALSO chash(VI); as(I)
DIAGNOSTICS "line too long" -- input line >131 characters
"symbol too long" -- symbol >20 characters
"too many symbols" -- >10 symbols in line
"cannot open t.?" -- bug; see author
"cannot fork; examine t.out" -- can't start sort
process; intermediate results are on files
t.0, t.1,t.2,t.3. These may be sorted inde-
pendently and the results concatenated by the
user.
"cannot sort" -- odd response from sort; examine
intermediate results, as above.
"impossible situation" -- system bug
"cannot open" file -- one of the input names
cannot be opened for reading.
BUGS The destruction of unsuspecting users' files
should soon be fixed. A limitation that may
eventually go away is the restriction to assem-
bler language format. There should be options for
FORTRAN, English, etc., lexical analysis.
File names longer than eight characters cause
misalignment in the output if tabs are set at ev-
ery eighth column.
OWNER lem