qopt-report-annotate, Qopt-report-annotate

Enables the annotated source listing feature and specifies its format.

Syntax

Linux and macOS:

-qopt-report-annotate[=keyword]

Windows:

/Qopt-report-annotate[:keyword]

Arguments

keyword

Specifies the format for the annotated source listing. You can specify one of the following:

text	Indicates that the listing should be in text format. This is the default if you do not specify `keyword`.
html	Indicates that the listing should be in html format.

Default

OFF	No annotated source listing is generated

Description

This option enables the annotated source listing feature and specifies its format. The feature annotates source files with compiler optimization reports.

By default, one annotated source file is output per object. The annotated file is written to the same directory where the object files are generated. If the object file is a temporary file and an executable is generated, annotated files are placed in the directory where the executable is placed. You cannot generate annotated files to a directory of your choosing.

However, you can output annotated listings to stdout, stderr, or to a file if you also specify option [q or Q]opt-report-file.

By default, this option sets option [q or Q]opt-report with default level 2.

The following shows the file extension and listing details for the two possible keywords.

Format	Listing Details
text	The annotated source listing has an .annot extension. It includes line numbers and compiler diagnostics placed after correspondent lines. IPO footnotes are inserted at the end of annotated file.
html	The annotated source listing has an .annot.html extension. It includes line numbers and compiler diagnostics placed after correspondent lines (as the text format does). It also provides hyperlinks in compiler messages and quick navigation with the routine list. IPO footnotes are displayed as tooltips.

IDE Equivalent

None

Alternate Options