Previous: Option file format, Up: Options
The second field of an option record can specify the following properties:
CommonTargetIt is possible to specify several different languages for the same
option. Each language must have been declared by an earlier
Language record. See Option file format.
RejectNegativeNegative(othername)Negative property of the option to be
turned off.
JoinedSeparateJoined indicates
that the option and argument can be included in the same argv
entry (as with -mflush-func=name, for example).
Separate indicates that the option and argument can be
separate argv entries (as with -o). An option is
allowed to have both of these properties.
JoinedOrMissingargv entry as the option itself.
This property cannot be used alongside Joined or Separate.
UIntegerVar(var)Mask or InverseMask properties,
var is the integer variable that contains the mask.
UInteger property,
var is an integer variable that stores the value of the argument.
The option-processing script will usually declare var in
options.c and leave it to be zero-initialized at start-up time.
You can modify this behavior using VarExists and Init.
Var(var, set)!set
when the “no-” form is used.
var is declared in the same way as for the single-argument form
described above.
VarExistsVar property already exists.
No definition should be added to options.c in response to
this option record.
You should use this property only if the variable is declared outside
options.c.
Init(value)Var property should be statically
initialized to value.
Mask(name)target_flags
variable (see Run-time Target) and is active when that bit is set.
You may also specify Var to select a variable other than
target_flags.
The options-processing script will automatically allocate a unique bit
for the option. If the option is attached to `target_flags',
the script will set the macro MASK_name to the appropriate
bitmask. It will also declare a TARGET_name macro that has
the value 1 when the option is active and 0 otherwise. If you use Var
to attach the option to a different variable, the associated macros are
called OPTION_MASK_name and OPTION_name respectively.
You can disable automatic bit allocation using MaskExists.
InverseMask(othername)InverseMask(othername, thisname)Mask(othername) property. If thisname is given,
the options-processing script will declare a TARGET_thisname
macro that is 1 when the option is active and 0 otherwise.
MaskExistsMask property already exists.
No MASK or TARGET definitions should be added to
options.h in response to this option record.
The main purpose of this property is to support synonymous options.
The first option should use `Mask(name)' and the others
should use `Mask(name) MaskExists'.
ReportUndocumentedCondition(cond)