Intel® Fortran Compiler 17.0 Developer Guide and Reference

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 statements, data types, directives, and other language keywords. Examples of statement keywords are WRITE, INTEGER, DO, and OPEN.

this type

Indicates command-line or option arguments, new terms, or emphasized text. Most new terms are defined in the Glossary.

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. Brackets are also used in code examples to show arrays.

item [, item ]...

Indicates that the item preceding the ellipsis (...) can be repeated. In some code examples, a horizontal ellipsis means that not all of the statements are shown.

Intel® Fortran

This term refers to the name of the common compiler language supported by the Intel® Fortran 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.

macOS* or macOS* operating system

These terms refer to all supported macOS* operating systems.

Microsoft Visual Studio*

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*, macOS*, or Windows* options, which are used by the compiler to compile applications.

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

  • Many options have names that are the same on Linux*, macOS*, and Windows*, except that the Windows* form starts with an initial / and the Linux* and macOS* form starts with an initial -. Within text, such option names are shown without the initial character. For example, check.

  • Many options have names that are the same on Linux*, macOS*, and Windows*, except that the Windows* form starts with an initial Q. Within text, such option names are shown as [Q]option-name.

    For example, if you see a reference to [Q]ip, the Linux* and macOS* form of the option is -ip and the Windows* form of the option is /Qip.

  • Several compiler options have similar names except that the Linux* and macOS* forms start with an initial q and the Windows* form starts with an initial Q. Within text, such option names are shown as [q or Q]option-name.

    For example, if you see a reference to [q or Q]opt-report, the Linux* and macOS* form of the option is -qopt-report and the Windows* form of the option is /Qopt-report.

Other dissimilar compiler option names are shown in full.

Conventions Used in Compiler Options

/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* and macOS* systems. For example:

  • Windows* option: /fast
  • Linux* and macOS* option: -fast

Note

If an option is available on Windows*, Linux*, and macOS* systems, no slash or dash appears in the general description of the option. The slash and dash only appear where the option syntax is described.

/option:argument or

-option=argument

Indicates that an option requires an argument (parameter). For example, you must specify an argument for the following options:

  • Windows* option: /Qdiag-error-limit:n
  • Linux* and macOS* option: -diag-error-limit=n

/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 /Qfnalign[:n] and -falign-functions[=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 Windows* option /[no]traceback, /traceback enables the option, while /notraceback disables it.

In the Linux* and macOS* 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-alias disables the -falias option.

Conventions Used in Language Reference

This color

Indicates Intel extensions (non-standard features) that may or may not be implemented by other compilers. Features defined by the Fortran 2008 Standard or the OpenMP 4.1 API are shown in black.

Fortran

This term refers to language information that is common to previously supported Fortran standards, Fortran 2008, and the Intel® Fortran Compiler.

Standard Fortran

This term refers to language information that is common to ANSI/ISO Fortran 95, ANSI/ISO Fortran 90, and Intel® Fortran.

Fortran 95

This term refers to language features specific to ANSI/ISO Fortran 95.

Fortran 2003

This term refers to language features specific to ANSI/ISO Fortran 2003.

Fortran 2008

This term refers to language features specific to ISO/IEC 1539-1:2010 (Fortran 2008).

integer

This term refers to the INTEGER(KIND=1), INTEGER(KIND=2), INTEGER (INTEGER(KIND=4)), and INTEGER(KIND=8) data types as a group.

real

This term refers to the REAL (REAL(KIND=4)), DOUBLE PRECISION (REAL(KIND=8)), and REAL(KIND=16) data types as a group.

REAL

This term refers to the default data type of objects declared to be REAL. REAL is equivalent to REAL(KIND=4), unless a compiler option specifies otherwise.

complex

This term refers to the COMPLEX (COMPLEX(KIND=4)), DOUBLE COMPLEX (COMPLEX(KIND=8)), and COMPLEX(KIND=16) data types as a group.

logical

This term refers to the LOGICAL(KIND=1), LOGICAL(KIND=2), LOGICAL (LOGICAL(KIND=4)), and LOGICAL(KIND=8) data types as a group.

< Tab>

This symbol indicates a nonprinting tab character.

^

This symbol indicates a nonprinting blank character.

Platform Labels

A platform is a combination of an operating system (OS) and a central processing unit (CPU), which provides a distinct environment for product use (in this case, a computer language). An example of a platform is Microsoft Windows* on processors using Intel® 64 architecture.

In this documentation, the information applies to all supported platforms unless it is otherwise labeled for a specific platform (or platforms).

These labels may be used to identify specific platforms:

L*X

Applies to a Linux* operating system.

M*X

Applies to a macOS* operating system.

W*S

Applies to a Microsoft Windows* operating system.