# qopt-report-annotate, Qopt-report-annotate

Enables the annotated source listing feature and specifies its format.

## Syntax

Linux: | -qopt-report-annotate[=keyword]

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

None

Parent topic: Optimization Report Options

## See Also

qopt-report, Qopt-report compiler option
qopt-report-file, Qopt-report-file compiler option
qopt-report-annotate-position, Qopt-report-annotate-position compiler option