443
edits
-
Changes
Cref
,Created page with " The cross reference list utility CREF is used to format raw cross-reference information produced by the compiler or the assembler into a sorted listing. A raw cross-reference..."
The cross reference list utility CREF is used to format
raw cross-reference information produced by the compiler or
the assembler into a sorted listing. A raw cross-reference
file is produced with the -CR option to the compiler. The
assembler will generate a raw cross-reference file with a -C
option (Z80 or 8086 assemblers) or by using an OPT CRE
directive (6800 series assemblers) or a REF control line
(8096 assembler).. The general form of the CREF command is:
CREF options files
where _�o_�p_�t_�i_�o_�n_�s is zero or more options as described below and
_�f_�i_�l_�e_�s is one or more raw cross-reference files. CREF takes
the following options:
-O_�o_�u_�t_�f_�i_�l_�e
Allows specification of the output file name. By
default the listing will be written to the standard
output and may be redirected in the usual manner.
Alternatively using the -O option an output file name
may be specified, e.g. -O_�x_�x_�x._�l_�s_�t.
-P_�w_�i_�d_�t_�h
This option allows the specification of the width to
which the listing is to be formatted, e.g. -P_�1_�3_�2 will
format the listing for a 132 column printer. The
default is 80 columns.
-L_�l_�e_�n_�g_�t_�h
Specify the length of the paper on which the listing is
to be produced, e.g. if the listing is to be printed
on 55 line paper you would use a -L_�5_�5 option. The
default is 66 lines.
-X_�p_�r_�e_�f_�i_�x
The -X option allows the exclusion of symbols from the
listing, based on a prefix given as argument to -X. For
example if it was desired to exclude all symbols start-
ing with the character sequence _�x_�y_�z then the option
-X_�x_�y_�z would be used. If a digit appears in the charac-
ter sequence then this will match any digit in the sym-
bol, e.g. -XX0 would exclude any symbols starting with
the letter _�X followed by a digit.
-F -F will exclude from the listing any references from
files with a full path name. A full path name means
either: a file name starting with a slash ('/') or
backslash ('\') or a file name starting with a CP/M
user number/drive letter prefix, e.g. 0:A:. This is
intended to force omission from the listing of any sym-
bol references derived from standard header files, e.g.
using -F would omit any references from the header file
STDIO.H.
-H_�s_�t_�r_�i_�n_�g
The -H option takes a string as an argument which will
be used as a header in the listing. The default heading
is the name of the first raw cross-ref information file
specified.
-S_�s_�t_�o_�p_�l_�i_�s_�t
The -S option should have as its argument the name of a
file containing a list of symbols not to be listed in
the cross-reference. Multiple stoplists may be supplied
with multiple -S options.
Cref will accept wild card filenames and I/O redirec-
tion. Long command lines may be supplied by invoking CREF
with no arguments and typing the command line in response to
the _�c_�r_�e_�f> prompt. A backslash at the end of the line will be
interpreted to mean that more command lines follow.
