Using the Annotated Source window

The Annotated Source window presents line-by-line performance data using the function's source code.

The Annotated Source window is available only for files that you compile using the -g debugging option.

The numeric annotations in the margin reflect the time recorded for that line or basic block over all calls to the function. By default, Quantify shows the function time for each line, scaled as a percentage of the total function time accumulated by the function.

For more information about how Quantify reports data for lines and basic blocks, read How Quantify handles basic blocks.

Changing annotations

By default, the annotations show function+descendant time. You can change this, and other characteristics of the annotated display, using the View menu.

Note that if you choose to show multi-block lines, selecting Annotations > Function time (% of function) gives the most accurate annotations for lines; other selections show values that may not add up to the total function time.

What annotations mean

Each source line in the Annotated Source window is marked with a character indicating the type of annotation.

Annotation
 

Meaning

      *

A comment line added by Quantify. By default, Quantify inserts function summaries, comments for each function that reflect its detailed function data. To eliminate comments, select View > Function summaries > Hide function summaries.

 

      |

 

The start of a single basic block or line. A basic block can span several lines.

 

      .

 

The extent of basic blocks that span several lines.

 

      +

 

A line containing multiple basic blocks.

 

      #

 

A line containing basic blocks that were not executed.

 

 

Here is an example of how annotations are used in the Annotated Source window: