Changes

CREF options files

where _�o_�p_�t_�i_�o_�n_�s <strong>options</strong> is zero or more options as described below and_�f_�i_�l_�e_�s <strong>files</strong> is one or more raw cross-reference files. CREF takes

;-O_�o_�u_�t_�f_�i_�l_�eO<strong>outfile</strong>:Allows specification of the output file name. Bydefault the listing will be written to the standardoutput and may be redirected in the usual manner.Alternatively using the -O option an output file namemay be specified, e.g. -O_�x_�x_�xO<strong>xxx._�l_�s_�tlst</strong>.

;-P_�w_�i_�d_�t_�hP<strong>width</strong>:This option allows the specification of the width towhich the listing is to be formatted, e.g. -P_�1_�3_�2 P<strong>132</strong> willformat the listing for a 132 column printer. Thedefault is 80 columns.

;-L_�l_�e_�n_�g_�t_�hL<strong>length</strong>:Specify the length of the paper on which the listing isto be produced, e.g. if the listing is to be printedon 55 line paper you would use a -L_�5_�5 L<strong>55</strong> option. Thedefault is 66 lines.

;-X_�p_�r_�e_�f_�i_�xX<strong>prefix</strong>:The -X option allows the exclusion of symbols from thelisting, based on a prefix given as argument to -X. Forexample if it was desired to exclude all symbols start-ing starting with the character sequence _�x_�y_�z <strong>xyz</strong> then the option-X_�x_�y_�z X<strong>xyz</strong> would be used. If a digit appears in the charac-ter character sequence then this will match any digit in the sym-bolsymbol, e.g. -XX0 would exclude any symbols starting withthe letter _�X <strong>X</strong> followed by a digit.

;-F :-F will exclude from the listing any references fromfiles with a full path name. A full path name meanseither: a file name starting with a slash ('/') orbackslash ('\') or a file name starting with a CP/Muser number/drive letter prefix, e.g. 0:A:. This isintended to force omission from the listing of any sym-bol symbol references derived from standard header files, e.g.using -F would omit any references from the header fileSTDIO.H.

;-H_�s_�t_�r_�i_�n_�gH<strong>string</strong>:The -H option takes a string as an argument which willbe used as a header in the listing. The default headingis the name of the first raw cross-ref information filespecified.

;-S_�s_�t_�o_�p_�l_�i_�s_�tS<strong>stoplist</strong>:The -S option should have as its argument the name of afile containing a list of symbols not to be listed inthe cross-reference. Multiple stoplists may be suppliedwith multiple -S options.

Cref will accept wild card filenames and I/O redirec-tionredirection. Long command lines may be supplied by invoking CREF

the _�c_�r_�e_�f<strong>cref</strong>> prompt. A backslash at the end of the line will be