NAME

       metaxref - builds cross-reference file/unit/item information

SYNOPSIS

       metaxref [ -dhkmsV ] [ -f manifest ] [ -L dir ]

DESCRIPTION

       Metaxref  is  a  program  that  scans  all the files in your MANIFEST file and produces three files which
       contains information about how the files in that MANIFEST reference items defined  by  metaconfig's  unit
       files.

       The  first  two  files,  I.fui and I.uif reference the file, unit and items sorted differently. The third
       file, Obsolete, dumps all the known obsolete symbols, in which file they appear and the new  symbol  that
       should be used instead.

       Note  that  obsolete  symbols do not appear in the main cross-reference files, but are only listed in the
       Obsolete file. That's yet another incentive to use the new symbols in your sources. :-)

OPTIONS

       Metaxref recognizes the following options:

       -d        Turn on debug mode.

       -f manifest
                 Use an alternate manifest file.

       -h        Print help message and exit.

       -k        Keep temporary .MT directory.

       -m        Assume lots of memory and swap space. This will drastically improve the symbol lookup  time  in
                 your source files, at the expense of memory usage.

       -s        Turn on silent mode.

       -L dir    Override default library location (where the U units directory can be found).

       -V        Print version number and exit.

       -X file   When  examining  the  source  files,  ignore any symbols listed in the file.  This is useful in
                 situations where a particular unit is known not to be needed  for  your  package's  portability
                 targets,  but  your  source  files  nevertheless  contain  occurrences  of  words  that look to
                 metaconfig like symbols defined in that unit. (For example, you might need the word "index"  in
                 a  source  file, but not need the unit that determines whether strcpy or index should be used.)
                 The file can contain blank lines, comment lines introduced with '#',  and  lines  containing  a
                 single symbol.  If this option is not supplied, any  variable in .package is honored instead.

AUTHOR

       Harlan Stenn <harlan@mumps.pfcs.com>

FILES

       LIB/dist/mcon/U/*.U
                 Public unit files.
       U/*.U     Private unit files
       I.fui     Lists information sorted by file, unit and item.
       I.uif     Lists information sorted by unit, item and file.
       Obsolete  Lists all the obsolete symbols used by the sources.

                      where LIB is /usr/share/dist.

BUGS

       Metaxref  will list among the wanted items all those magic symbols defined within units on the ?M: lines.
       Those are relevant only when metaconfig is invoked with the -M option.

SEE ALSO

       metaconfig(1), metalint(1)

                                                 Version 3.5 PL0                                     METAXREF(1)