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

To change annotations, use the View menu. You can select both function and function+descendants data, either in cycles or seconds and as a percentage of the function+descendants 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: