To add Intel Advisor annotations into your source files, you can use the Visual Studio* code editor. Intel Advisor simplifies the process of adding annotations so you do not need to type the annotation names. Alternatively, you can use the annotation assistant in the Survey Report or Survey Source windows, or when using the Visual Studio code editor, the Annotation Wizard. Alternatively, you can type the exact macro name and its arguments manually, as described in this topic.
To add Intel Advisor annotations:
- Select the code region around which you will add your first annotation, such as a parallel site. Carefully include the correct group of lines, including any opening and closing braces ({ and }) needed. For example:
![Select the code region by dragging the mouse pointer]()
- Within the highlighted code region, right-click the mouse to display the context menu. Select Intel Advisor XE 2015 and the type of annotation to be added, such as Intel Advisor XE 2015> Annotate Site. For example:
![Choose the type of annotations to add from the context menu.]()
- This adds the selected type of annotations. For the begin site annotation, Intel Advisor adds a unique annotation identifier as an argument.
![Replace the placeholder (<site_name>) with a unique identifier (solve)]()
You should replace the added name with a name that helps you quickly identify its source location. For example, in place of MySite1 in the argument to ANNOTATE_SITE_BEGIN() and ANNOTATE_SITE_END() shown above, you might instead type the word solve (the function name). The added name must be unique amongst the annotations in this project. Annotation name arguments for:
C/C++ code use an ASCII C++ identifier.
Fortran code use a character constant.
C# code use a string
This enables you to quickly add annotations into the appropriate source files.
This wizard provides only the more frequently used annotations, so some annotations are not available in this wizard. Either use the Survey windows' annotation assistant to copy other annotations (see the help topic Copying Annotations and Build Settings Using the Annotation Assistant Pane) or type the annotations into your code editor (see Summary of Annotation Types).
If a C/C++ loop only executes a single statement and does not contain an opening brace ({) to allow multi-statement execution, add braces ({ and }) around the existing statement and the annotation.