.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, it will take the next
available argument to be an
.it ignore
file name; if the
.bd \*-o
option is given, the next
available argument will be taken as an
.it only
file name.
.it Ignore
and
.it only
files should be lists of symbols separated by new lines.
If an
.it ignore
file is given, all the symbols in that file
will be ignored in columns (1) and (3) of the output.
If an
.it only
file is given, only symbols appearing in that
file will appear in column (1).
Only one of the options
.bd \*-i
or
.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 temoprary 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), sort(I)
.sh BUGS
