-

Cref

From HI-TECH C for CP/M Fan WIKI(EN)
Revision as of 16:42, 26 July 2017 by Kumokosi (talk | contribs) (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...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

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.