The following sections describe the compiler options and their
usage. Compiler options are listed alphabetically. All compiler
options are supported by both the XL C and XL C++ compiler, unless
the option title is followed by "(C only)" or "(C++ only)".
For each option, the following information is provided:
- Category
- The functional category to which the option belongs is listed
here.
- Pragma equivalent
- Many compiler options allow you to use an equivalent pragma directive
to apply the option's functionality within the source code, limiting
the scope of the option's application to a single source file, or
even selected sections of code. Where an option supports the #pragma
options (option_name) and/or #pragma name form
of the directive, this is indicated.
- Purpose
- This section provides a brief description of the effect of the
option (and equivalent pragmas), and why you might want to use it.
- Syntax
- This section provides the syntax for the option.
- Defaults
- In most cases, the default option setting is clearly indicated
in the syntax diagram. However, for many options, there are multiple
default settings, depending on other compiler options in effect. This
section indicates the different defaults that may apply.
- Parameters
- This section describes the suboptions that are available for the
option.
- Usage
- This section describes any rules or usage considerations you should
be aware of when using the option. These can include restrictions
on the option's applicability, valid placement of pragma directives,
precedence rules for multiple option specifications, and so on.
- IPA effects
- Where appropriate, provides information on the effect of the option
during the IPA compile and/or IPA link steps.
- Predefined macros
- Many compiler options set macros that are protected (that is,
cannot be undefined or redefined by the user). Where applicable, any
macros that are predefined by the option, and the values to which
they are defined, are listed in this section.
- Examples
- Where appropriate, examples of the command-line syntax are provided
in this section.
- Related information
- Where appropriate, provides cross-references to related information.