1 01/14/87  pascal_cross_reference, pascal_cref
 2 
 3 Syntax as a command:  pascal_cref pathnames {-control_args}
 4 
 5 
 6 Function:  examines a set of Pascal object segments that import
 7 variables and procedures.
 8 
 9 
10 Arguments:
11 pathnames
12    are absolute or relative pathnames of Pascal object segments.  They
13    must have been compiled with -table.
14 
15 
16 Control arguments:
17 -external_references, -ext_refs
18    includes line numbers of statements where external (i.e., imported
19    or exported) variables and procedures are referenced or set.  The
20    modules must have been compiled with -reference_table to include
21    this information.
22 -internal_references, -int_refs
23    includes a list of internal variables or procedures and line numbers
24    of statements where they are referenced or modified.  The modules
25    must have been compiled with -reference_table to include this
26    information.
27 -no_external_references, -no_ext_refs
28    excludes line numbers of statements where external variables and
29    procedures are referenced.  (Default)
30 -no_internal_references, -no_int_refs
31    excludes a list of internal variables and procedures.  (Default)
32 -output_file path, -of path
33    produces a listing named path.x_map.  If you use no .x_map suffix as
34    part of the pathname, it is assumed.  You must specify -of to get a
35    cross-reference list including include files used and error
36    reporting; otherwise the command writes any error or warning
37    messages on error_output.
38 
39 
40 Notes:  The modules must have been compiled with -table.  The
41 cross-referencer checks declarations of shared variables and
42 procedures, producing an error list of differences between modules.  It
43 also notes if the difference may have undesirable results, for example,
44 destruction of data outside the program, such as may occur when sizes
45 of shared objects do not match.  Warnings are printed if types do not
46 match but object sizes do.
47 
48 Unlike the cross_reference command, pascal_cref includes no
49 declarations of variables and procedures in the listing, nor does it
50 compare types.  It accepts no modules generated by other translators.