KAP directives enable, disable, or modify a feature of KAP. Directives function as command switches used within the input file rather than on the command line. To invoke a directive, you must either toggle the directive on, or set a desired value for its level.
With the exception of the C*$* assertions
directive,
using KAP directives will not affect the correctness of a program.
Enabling KAP assertions allows you, through the use of specific
assertions, to provide KAP with false information that might lead
KAP to perform incorrect transformations. See Chapter 6.
Most KAP directives have corresponding command switches. If
conflicting settings are given on the command line and in a
directive, KAP uses the value specified on the directive. If
command-line control is desired, directives can be disabled (treated
as comments) with the -nodirectives
switch.
The C*$* inline
and C*$* ipa
directives
are disabled by default. When they are enabled, they take precedence
over the inlining and IPA switches.
See Chapter 4 for the command switches related to these directives.
KAP recognizes the Digital Fortran CDEC$
directive.
Except for the cpar$ do_parallel
directive, KAP
copies them to the transformed code file but otherwise ignores
them. A cpar$ do_parallel
directive is copied to the
transformed code file and the immediately following loop nest is
left unchanged.