Conventions and terminology used in this document

The following sections discuss the conventions used in this document.

Typographical conventions

The following table explains the typographical conventions used in this document.

Table 1. Typographical conventions
Typeface Indicates Example
bold Commands, executable names, and compiler options. By default, if you use the -qsmp compiler option in conjunction with one of these invocation commands, the option -qdirective=IBM*:SMP$:$OMP:IBMP:IBMT will be on.
italics Parameters or variables whose actual names or values are to be supplied by the user. Italics are also used to introduce new terms. The maximum length of the trigger_constant in fixed source form is 4 for directives that are continued on one or more lines.
UPPERCASE bold Fortran programming keywords, statements, directives, and intrinsic procedures. The ASSERT directive applies only to the DO loop immediately following the directive, and not to any nested DO loops.
lowercase bold Lowercase programming keywords and library functions, compiler intrinsic procedures, file and directory names, examples of program code, command strings, or user-defined names. If you call omp_destroy_lock with an uninitialized lock variable, the result of the call is undefined.

Qualifying elements (icons and bracket separators)

This document uses icons to delineate small segments of text as follows:

Table 2. Qualifying elements
Icon Meaning
Fortran 2003 begins
Fortran 2003 ends
The text describes an IBM(R) XL Fortran implementation of the Fortran 2003 standard.
Fortran 95 begins
Fortran 95 ends
The text describes an IBM XL Fortran implementation of the Fortran 95 standard.
IBM extension begins
IBM extension ends
The text describes a feature that is an IBM XL Fortran compiler extension to the standard language specifications.

This document uses marked bracket separators to delineate large blocks of standards-specific and extensions text as follows:

Fortran 2003 Standard

Text delineating Fortran 2003 standard-specific information.

End of Fortran 2003 Standard
Fortran 95

Text delineating Fortran 95 standard-specific information.

End of Fortran 95
IBM Extension

Text delineating extensions to the FORTRAN 77, Fortran 90, Fortran 95 and Fortran 2003 standards, where an extension is any processor dependent value or behavior.

End of IBM Extension

How to read syntax diagrams

Throughout this document, diagrams illustrate XL Fortran syntax. This section will help you to interpret and use those diagrams.

If a variable or user-specified name ends in _list, you can provide a list of these terms separated by commas.

You must enter punctuation marks, parentheses, arithmetic operators, and other special characters as part of the syntax.

Sample syntax diagram

The following is an example of a syntax diagram with an interpretation:

Read syntax diagramSkip visual syntax diagram                                              .-,-.
           (1)                                V   |
>>-EXAMPLE-------char_constant--+-a-+--+---+----e-+------------->
                                '-b-'  +-c-+
                                       '-d-'
 
>--name_list---------------------------------------------------><
 
Notes:
  1. IBM Extension

Interpret the diagram as follows:

Examples

The examples in this document are coded in a simple style that does not try to conserve storage, check for errors, achieve fast performance, or demonstrate recommended practice.