Notational Conventions

Information in this documentation applies to all supported operating systems and architectures unless otherwise specified. This documentation uses the following conventions:

Notational Conventions

THIS TYPE

Indicates language keywords.

this type

Indicates command-line or option arguments.

This type

Indicates a code example.

This type

Indicates what you type as input.

This type

Indicates menu names, menu items, button names, dialog window names, and other user-interface items.

File > Open

Menu names and menu items joined by a greater than (>) sign to indicate a sequence of actions. For example, Click File > Open indicates that in the File menu, you would click Open to perform this action.

{value | value}

Indicates a choice of items or values. You can usually only choose one of the values in the braces.

[item]

Indicates items that are optional.

item [, item ]...

Indicates that the item preceding the ellipsis (...) can be repeated.

Intel® C++

This term refers to the name of the common compiler language supported by the Intel® oneAPI DPC++/C++ Compiler.

compiler or the compiler

These terms are used when information is not limited to only one specific compiler, or when it is not necessary to indicate a specific compiler.

Windows or Windows operating system

These terms refer to all supported Microsoft Windows operating systems.

Linux or Linux operating system

These terms refer to all supported Linux operating systems.

*

An asterisk at the end of a word or name indicates it is a third-party product trademark.

compiler option

This term refers to Linux or Windows options, which are used by the compiler to compile applications.

Additional Conventions Used for Compiler Options

compiler option name shortcuts

The following conventions are used as shortcuts when referencing compiler option names in descriptions:

  • No initial – or /

    This shortcut is used for option names that are the same for Linux and Windows except for the initial character.

    For example, Fa denotes:

    • Linux: -Fa

    • Windows: /Fa

  • [Q]option-name

    This shortcut is used for option names that only differ because the Windows form starts with a Q.

    For example, [Q]ipo denotes:

    • Linux: -ipo

    • Windows: /Qipo

  • [q or Q]option-name

    This shortcut is used for option names that only differ because the Linux form starts with a q and the Windows form starts with a Q.

    For example, [q or Q]opt-report denotes:

    • Linux: -qopt-report

    • Windows: /Qopt-report

More dissimilar compiler option names are shown in full.

/option or

-option

A slash before an option name indicates the option is available on Windows. A dash before an option name indicates the option is available on Linux systems. For example:

  • Linux : -help
  • Windows: /help

Note

If an option is available on all supported operating systems, no slash or dash appears in the general description of the option. The slash and dash will only appear where the option syntax is described.

/option:argument or

-option=argument

Indicates that an option requires an argument (parameter).

/option:keyword or

-option=keyword

Indicates that an option requires one of the keyword values.

/option[:keyword ] or

-option[=keyword ]

Indicates that the option can be used alone or with an optional keyword.

option[n] or

option[:n] or

option[=n]

Indicates that the option can be used alone or with an optional value. For example, in -unroll[=n], the n can be omitted or a valid value can be specified for n.

option[-]

Indicates that a trailing hyphen disables the option. For example, /Qglobal_hoist- disables the Windows option /Qglobal_hoist.

[no]option or

[no-]option

Indicates that no or no- preceding an option disables the option. For example:

In the Linux option -[no-]global_hoist, -global_hoist enables the option, while -no-global_hoist disables it.

In some options, the no appears later in the option name. For example, -fno-common disables the -fcommon option.