XRFMRG prompts for the file name of each cross-reference file and then prompts for an output file for the consolidated listing. The consolidated listing has a format similar to a cross-reference file produced by the compiler, and may itself be used as input to XRFMRG. XRFMRG accepts a file containing a list of input file names (one per line) in response to the Next input file prompt if it is preceded by the character @.

A sample session with XRFMRG (assume that the MODULEs LINCOM and SAMPLE have been compiled with the ITFXREF subcommand):

MAINSAIL (R) Version 16.20.<release> (? for help)
Revision: <date>
Copyright (c) 1984-1998 by XIDAK, Inc., Point Arena,
 California, USA.
*xrfmrg<eol>
Next input file (@indirect, eol to stop): lincom.xrf<eol>
Next input file (@indirect, eol to stop): sample.xrf<eol>
Next input file (@indirect, eol to stop): <eol>
Output file: linsmp.xrf<eol>

A sample output file from XRFMRG (Sections 4.18 and 4.10 describe the output format):

Combined Cross Reference for MODULE(s) LINCOM SAMPLE

$ARYMOD.NEWARRAY1
    (m:lincom) LINCOM.INITIALPROC 8.37
$DPYEXE.$DPYSTTYWRITE
    (m:tops20) LINCOM.STTYWRITE 4.9
$DPYEXE.$DPYTTYREAD
    (m:syslib) SAMPLE.TTYREAD 10.18
$DSPMOD.ARYDISPOSE
    (m:lincom) LINCOM.INITIALPROC 8.43
$DSPMOD.NEWUPPERBOUND
    (m:lincom) LINCOM.SYNCHRONIZE 7.43 7.44
$ERRMOD.$FILEERROR
    (m:syslib) LINCOM.SFWRITE 13.9 LINCOM.CFREAD 16.10
    LINCOM.CFWRITE 17.8 LINCOM.GETPOS 20.8
    LINCOM.SETPOS 21.7
$ERRMOD.ERRMSG
    (m:syslib) LINCOM.SETPOS 21.10

The following shows how to specify an indirect command file as input to XRFMRG:

*xrfmrg<eol>
Next input file ... : @indirectCmdFile<eol>
Next input file ... : <eol>
Output file: merged.xrf<eol>

The file indirectCmdFile must contain the names of each input file to XRFMRG, one per line.

For a description of a simple keyword cross-reference utility, look under XREF in the Chapter 36 of the MAINSAIL Utilities User's Guide.