load-names filename merge

Load the names database with the contents of filename. When invoked interactively, a file browser is provided to aid in locating the file.

Name-database files are created using the utility program aa.tags. Each entry in such a file contains the name of a declared item, its sort (e.g., package, a procedure, etc.), its kind (e.g., specification, body, etc.), and the filename and line number on which the declaration occurs.

If merge is Yes, new entries are merged into the database. In particular, each entry contained in filename will be added to the database unless the database already contains exactly the same entry. Thus, tags files corresponding to intersecting sets of files can be merged and the database will contain the union of the entries. Note, however, that merging tags files that correspond to different versions of an Ada file is not a good idea. In particular, doing so will cause the database to contain multiple entries for each entity whose characterization changes, e.g., that shifts to a new line in the modified file.

If merge is No, the old contents of the database are discarded before filename is loaded.

For each match found by the search, a one-line description appears in the list widget. The default format is:

name: sort kind

So for example, Ada-ASSURED may be invoked as follows:

X	aa -xrm '*nameMatchFormat: %N %T %K : "%F", %L'
MS	aa -command "(define sg:name-match-format \"%N %T %K : \\\"%F\\\", %L\")"