.th CREF I 2/5/73
.sh NAME
cref  \*-  make cross reference listing
.sh SYNOPSIS
.bd cref
[
.bd \*-acilostux123
] name ...
.sh DESCRIPTION
.it Cref
makes a cross reference listing
of program files in assembler or C format. The files
named as arguments in the command
line are searched for symbols 
in the appropriate syntax.
.s3
The output report is in four columns:
.nf
.s3
(1)	(2)	(3)	(4)
symbol	file	see	text as it appears in file
		below
.s3
.fi
.it Cref
uses either an
.it ignore
file or an
.it only
file.
If the
.bd \*-i
option is given, the next
argument is taken to be an
.it ignore
file; if the
.bd \*-o
option is given, the next
argument is taken to be
an
.it only
file.
.it Ignore
and
.it only
files are lists of symbols separated by new lines.
All symbols in an
.it ignore
file
are ignored in columns (1) and (3) of the output.
If an
.it only
file is given, only symbols in that
file appear in column (1).
At most one of
.bd \*-i
and
.bd \*-o
may be used.
The default setting
is
.bd \*-i.
Assembler predefined symbols or C keywords are ignored.
.s3
The
.bd \*-s
option causes current symbols to be
put in column 3.
In the assembler, the current symbol
is the most recent name symbol;
in C, the current function name.
The
.bd \*-l
option causes the line number within the file
to be put in column 3.
.s3
The
.bd \*-t
option causes the next available argument
to be used as the name
of the intermediate temporary
file (instead of /tmp/crt??).
The file is created and
is not removed at the end of the process.
.s3
Options:
.s3
.lp +5 3
\fBa\fR	assembler format (default)
.lp +5 3
\fBc\fR	C format input
.lp +5 3
\fBi\fR	use
.it ignore
file (see above)
.lp +5 3
\fBl\fR	put line number in col. 3 (instead of current symbol)
.lp +5 3
\fBo\fR	use
.it only
file (see above)
.lp +5 3
\fBs\fR	current symbol in col. 3 (default)
.lp +5 3
\fBt\fR	user supplied temporary file
.lp +5 3
\fBu\fR	print only symbols that occur exactly once
.lp +5 3
\fBx\fR	print only C external symbols
.lp +5 3
\fB1\fR	sort output on column 1 (default)
.lp +5 3
\fB2\fR	sort output on column 2
.lp +5 3
\fB3\fR	sort output on column 3
.s3
.i0
.sh FILES
.dt
/tmp/crt??	temporaries
.br
/usr/lib/aign	default assembler 
.it ignore
file
.br
/usr/lib/cign	default C
.it ignore
file
.br
/usr/bin/crpost	post processor
.br
/usr/bin/upost	post processor for
.bd \*-u
option
.br
/bin/sort	used to sort temporaries
.br
.s3
.fi
.sh "SEE ALSO"
as (I), cc (I)
.sh BUGS