XL Fortran Enterprise Edition for AIX : User's Guide - IBM

-qdirective Option
Syntax
-qdirective[=directive_list] | -qnodirective[=directive_list]
DIRECTIVE[(directive_list)] | NODIRECTIVE[(directive_list)]
Specifies sequences of characters, known as trigger constants, that identify
comment lines as compiler comment directives.
Background Information
A compiler comment directive is a line that is not a Fortran statement but is
recognized and acted on by the compiler. To allow you maximum flexibility, any
new directives that might be provided with the XL Fortran compiler in the future
will be placed inside comment lines. This avoids portability problems if other
compilers do not recognize the directives.
Defaults
The compiler recognizes the default trigger constant IBM*. Specification of -qsmp
implies -qdirective=smp\$:\$omp:ibmp, and, by default, the trigger constants
SMP$, $OMP, and IBMP are also turned on. If you specify -qsmp=omp, the
compiler ignores all trigger constants that you have specified up to that point and
recognizes only the $OMP trigger constant. Specification of -qthreaded implies
-qdirective=ibmt, and, by default, the trigger constant IBMT is also turned on.
Arguments
The -qnodirective option with no directive_list turns off all previously specified
directive identifiers; with a directive_list, it turns off only the selected identifiers.
-qdirective with no directive_list turns on the default trigger constant IBM* if it has
been turned off by a previous -qnodirective.
Notes
v Multiple -qdirective and -qnodirective options are additive; that is, you can turn
directive identifiers on and off again multiple times.
v One or more directive_lists can be applied to a particular file or compilation unit;
any comment line beginning with one of the strings in the directive_list is then
considered to be a compiler comment directive.
v The trigger constants are not case-sensitive.
v The characters (, ), ', ", :, =, comma, and blank cannot be part of a trigger
constant.
v To avoid wildcard expansion in trigger constants that you might use with these
options, you can enclose them in single quotation marks on the command line.
For example:
xlf95 -qdirective=’dbg*’ -qnodirective=’IBM*’ directives.f
v This option only affects Fortran directives that the XL Fortran compiler provides,
not those that any preprocessors provide.
148 XL Fortran Enterprise Edition for AIX : User’s Guide