When you determine that a file must always be run with the same command qualifiers, you can use the first line of the file to specify these qualifiers. The format of this line is as follows:
C*$*options /qualifier[=value] [/qualifier[=value]]...
The C*$*options (or *$*options ) must
appear in columns 1 through 11 (or 1 through 10) with a character
space between this command and the options that follow, such as:
C*$*options /lines=60 /optimize=4 /scalaropt=2
Only the first line may be used for C*$*options . Short
or long qualifier names may be used on this line. The leading C, the
keyword options, and the command-line qualifiers can be uppercase or
lowercase.
Qualifiers of the form /qualifier=<name> (for example,
/fortran or /inline ) cannot be specified
on the C*$*options line of the source file. These
qualifiers can be specified on the command line only.
If conflicting qualifiers are specified on the command line and
on the C*$*options line, the C*$*options
line takes precedence. If additional options are specified on the
C*$*options line, these are used in addition to those
specified on the command line. If the command qualifier
/ignoreoptions is set, the C*$*options line
in the program is treated as a comment.
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 qualifier.
The C*$* inline and C*$* ipa directives
are disabled by default. When they are enabled, they take precedence
over the inlining and IPA qualifiers.
See Chapter 4 for the command qualifiers related to these directives.