4.9 C*$* options

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.


Previous Page | Next Page | Contents | Index |
Command-Line Qualifiers