Operation

The program is a command line utility used as follows:

    xref [-]filename.ext { [-]filename.ext }

The - indicates that a file is a list of files. One or more files can be placed on the command line. If there are no command line arguments, the program prompts for a file name. At the prompt, only one file name is accepted; it can be a file containing a list of file names.

As each file is processed, the message:

    Processed filename

is displayed. When the operation is complete, the cross reference table is written to a file titled xref.out in the local directory. Any previous output file is overwritten. The file is in DOS text format.

Sample list file

xref.cpp 
scanner.cpp scanner.h
symtab.cpp  symtab.h

Error messages

When an error occurs, one of several error messages is usually generated. These are listed below with some additional guidance.

No files were processed

This message occurs when none of the files in the command line or files listed in a list file could be opened.

Out of memory

No more dynamic memory is available for processing. The files contain too much data for this program.

Can't open filename

The named file could not be opened for processing. An invalid path is the most likely cause.