-Xlist Suboption Reference

This section describes the --Xlist suboptions. As noted, some are only available with f77.

-f77: -Xlistc -- Show call graphs and cross-routine errors

Used alone, --Xlistc does not show a listing or cross-reference. It produces the call graph in a tree form, using printable characters. If some subroutines are not called from MAIN, more than one graph is shown. Each BLOCKDATA is printed separately with no connection to MAIN.

The default is not to show the call graph.

--XlistE - Show cross-routine errors

Used alone, --XlistE shows only cross-routine errors and does not show a listing or a cross-reference.

- -Xlisterr[nnn] - Suppress error nnn

Use --Xlisterr to suppress a numbered error message from the listing or cross-reference.

For example: -Xlisterr338 suppresses error message 338. If nnn is not specified, all error messages are suppressed. To suppress additional specific errors, use this option repeatedly.

f77: -Xlist-f - Produce faster output

Use --Xlistf to produce source file listings and a cross-checking report and to verify sources, but without generating object files.

The default without this option is to generate object files.

f77: -Xlist-flndir - Put .fln files into dir directory

Use --Xlistfln to specify the directory to receive .fln source analysis files. The directory specified (dir) must already exist. The default is to include the source analysis information directly within the object .o files (and not generate .fln files).

f77: -Xlist-h - Halt on errors

With --Xlisth, compilation stops if errors are detected while cross-checking the program. In this case, the report is redirected to stdout instead of the *.lst file.

-Xlist-I - List and cross-check include files

If -XlistI is the only suboption used, include files are shown or scanned along with the standard -Xlist output (line numbered listing, error messages, and a cross-reference table).

• Listing--If the listing is not suppressed, then the include files are listed in place. Files are listed as often as they are included. The files are:

  • Source files

  • #include files

  • INCLUDE files

• Cross-Reference Table--If the cross reference table is not suppressed, the following files are all scanned while the cross reference table is generated:

  • Source files

  • #include files

  • INCLUDE files

    The default is not to show include files.

-Xlist-L - Show listing and cross routine errors

Use --XlistL to produce only a listing and a list of cross routine errors. This suboption by itself does not show a cross reference table. The default is to show the listing and cross reference table.

-Xlist-ln - Set the page length for pagination to n lines

Use --Xlistl to set the page length to something other than the default page size. For example, -Xlistl45 sets the page length to 45 lines. The default is 66.

With n=0 (-Xlistl0) this option shows listings and cross-references with no page breaks for easier on-screen viewing.

-Xlist-o name - Rename the -Xlist output report file

Use --Xlisto to rename the generated report output file. (A space between o and name is required.) With --Xlisto name, the output is to name.lst .

To display directly to the screen, use the command: -Xlisto /dev/tty

f77: -Xlist-s - Suppress unreferenced identifiers

Use --Xlists to suppress from the cross reference table any identifiers defined in the include files but not referenced in the source files.

This suboption has no effect if the suboption -XlistI is used.

The default is not to show the occurrences in #include or INCLUDE files.

f77: -Xlist-vn - Set level of checking strictness

n is 1,2, 3, or 4. The default is 2 (-Xlistv2):

• -Xlistv1

  Shows the cross-checked information of all names in summary form only, with no line numbers. This is the lowest level of checking strictness--syntax errors only.

• -Xlistv2

  Shows cross-checked information with summaries and line numbers. This is the default level of checking strictness and includes argument inconsistency errors and variable usage errors.

• -Xlistv3

  Shows cross-checking with summaries, line numbers, and common block maps. This is a high level of checking strictness and includes errors caused by incorrect usage of data types in common blocks in different subprograms.

• -Xlistv4

  Shows cross-checking with summaries, line numbers, common block maps, and equivalence block maps. This is the strictest level of checking with maximum error detection.

-Xlist-w[nnn] - Set width of output line to n columns

Use --Xlistw to set the width of the output line. For example, -Xlistw132 sets the page width to 132 columns. The default is 79.

-Xlist-war[nnn] - Suppress warning nnn in the report

Use --Xlistwar to suppress a specific warning message from the output reports. If nnn is not specified, then all warning messages are suppressed from printing. For example, -Xlistwar338 suppresses warning message number 338. To suppress more than one, but not all warnings, use this option repeatedly.

-Xlist-X - Show cross-reference table and cross routine errors

--XlistX produces a cross reference table and cross routine error list but no source listing.