C++ User's Guide

How Option Information Is Organized

To facilitate your information search, compiler option information has been separated into the following subsections. If the option is one that is replaced by or identical to some other option, see the description of the other option for full details.

Subsection 

Contents 

Option Definition 

A short definition immediately follows each option. (There is no heading for this category.) 

Values  

If the option has one or more values, this section defines each value. 

Defaults 

If the option has a primary or secondary default value, it is stated here.  

 

The primary default is the option value in effect if the option is not specified. For example, if -compat is not specified, the default is -compat=5.

 

The secondary default is the option in effect if the option is specified, but no value is given. For example, if -compat is specified without a value, the default is -compat=4.

Expansions  

If the option has a macro expansion, it is shown in this section. 

Examples 

If an example is needed to illustrate the option, it is given here. 

Interactions  

If the option interacts with other options, the relationship is discussed here. For example, the -xinline option should not be used if -xO is less than 3.

Warnings  

If there are cautions regarding use of the option, they are noted here, as are actions that might cause unexpected behavior.  

See also 

This section contains references to further information in other options or documents. 

"Replace With," "Same as," or "Use" 

If an option has become obsolete and been replaced by another, or the use of one option is preferred over another, the replacement option is noted here. For example, "Replace with -xO" or "Use -xO" means that -xO is the preferred option. Options described this way may not be supported in future releases.

 

If one option is an abbreviation for a longer option, the expansion is shown with "Same as." If there are two options with the same general meaning and purpose, the preferred option is referenced here. For example, "Same as -xO" indicates that -xO is the preferred option.