Series 300 Only

NAME

ada.xref − Ada cross-referencer

SYNOPSIS

ada.xref [ -l ] file

DESCRIPTION

Ada.xref is a tool that produces a list of references for each name encountered in the compilation unit(s) submitted to it. It works in either source or library modes, defined as follows:

source mode Ada.xref gathers information directly from an Ada source file.  In this mode, ada.xref requires the source file suffix to be .adx, where x is any one character. The advantage of this mode is that the compilation unit(s) need not be compiled. 

library mode Ada.xref fetches the information stored in the library at compile time. In this mode, the file contains a list of compilation units along with the library name(s) containing the actual compilation units (that is, not imported compilation units).  The compilation units specified must have been compiled with the -k option of the ada(1) command.  The advantage of this mode is that ada.xref can identify Ada objects precisely, resolve overloading, understand deferred constants, and extend the cross-references to parent and "withed" units not directly submitted. 

The following options are recognized:

−l Indicate library mode cross-referencing to be performed (default is source mode). 

In the library mode, any number of libraries can be specified, but all must belong to the same family. The library names are specified in the file using the following syntax:

use library_name

and the unit names are specified in the file using the following syntax:

unit_name [ specification | body | all ]

where the optional unit parameter defines whether to cross-reference the specification, body or both the specification and body of the specified unit. By default, only the body of the specified unit_name is cross-referenced. 

Environment Variables

Two environment variables, ADA_PATH and ADA_PREDEF_LIB, are associated with all components of the the Ada compilation system.  Both must be set properly and exported before any component of the Ada compilation system (including ada.xref) can be used (see ada(1), Environment Variables). 

AUTHOR

Ada.xref was developed by HP and Alsys. 

FILES

$ADA_PATH/ada.xref.bin Ada cross-referencer subprocess. 

SEE ALSO

ada(1), ada.fmgr(1), ada.format(1), ada.mklib(1), ada.mvlib(1), ada.protect(1), ada.probe(1), ada.rmlib(1), ada.umgr(1), ada.unlock(1). 

Ada Tools Manual, HP Part No. 98860-90020. 

Ada User’s Guide (Series 300), HP Part No. 98860-90000. 

INTERNATIONAL SUPPORT

8-bit file names. 

Hewlett-Packard Company  —  May 11, 2021