Lines Matching +full:software +full:- +full:properties +full:- +full:common

1 @c Copyright (C) 2003-2020 Free Software Foundation, Inc.
8 @cindex @samp{optc-gen.awk}
10 Most GCC command-line options are described by special option
16 * Option properties::    Supported option properties
35 @xref{Option properties}.
51 @code{Var} properties.
73 @file{options.c} or @file{options-save.c} file should include.  This
83 the string @samp{Enum}, a space-separated list of properties and help
84 text used to describe the set of strings in @option{--help} output.
85 Properties use the same format as option properties; the following are
91 option properties.
107 string @samp{EnumValue} and a space-separated list of properties.
108 Properties use the same format as option properties; the following are
132 @option{-march=native} that are processed by the driver so that
133 @samp{gcc -v} shows how the options chosen depended on the system on
141 the name of the option, with the leading ``-'' removed
143 a space-separated list of option properties (@pxref{Option properties})
145 the help text to use for @option{--help} (omitted if the second field
150 implicitly assumed to take a ``no-'' form.  This form should not be
152 does not have a ``no-'' form, you can use the @code{RejectNegative}
155 The help text is automatically line-wrapped before being displayed.
156 Normally the name of the option is printed on the left-hand side of
165 @samp{Mask(@var{x})}.  The options-processing script will automatically
166 allocate a bit in @code{target_flags} (@pxref{Run-time Target}) for
178 @node Option properties
179 @section Option properties
182 properties.  When an option takes an argument, it is enclosed in parentheses
193 @item Common
197 The option is available for all languages but is target-specific.
215 The option does not have a ``no-'' form.  All options beginning with
216 ``f'', ``W'' or ``m'' are assumed to have a ``no-'' form unless this
221 the option name with the leading ``-'' removed.  This chain action will
225 with @code{Joined} or @code{JoinedOrMissing} properties, unless the
229 As a consequence, if you have a group of mutually-exclusive
230 options, their @code{Negative} properties should form a circular chain.
231 For example, if options @option{-@var{a}}, @option{-@var{b}} and
232 @option{-@var{c}} are mutually exclusive, their respective @code{Negative}
233 properties should be @samp{Negative(@var{b})}, @samp{Negative(@var{c})}
240 entry (as with @code{-mflush-func=@var{name}}, for example).
242 separate @code{argv} entries (as with @code{-o}).  An option is
243 allowed to have both of these properties.
264 The option's argument is a non-negative integer consisting of either
269 with options like @code{-falign-loops} where both @code{-falign-loops}
270 and @code{-falign-loops}=@var{n} are supported to make sure the saved
275 The option's argument is a non-negative integer consisting of either
294 may be followed by a @samp{byte-size} suffix designating a multiple of bytes
299 such as @option{-Wlarger-than=}.
310 via @option{-Wp,}; new options should not have this property.
325 when the ``no-'' form is used.
327 @var{var} is declared in the same way as for the single-argument form
332 If the option uses the @code{Mask} or @code{InverseMask} properties,
339 option is used and 0 when the ``no-'' form is used.
364 The option-processing script will usually zero-initialize @var{var}.
374 variable (@pxref{Run-time Target}) and is active when that bit is set.
378 The options-processing script will automatically allocate a unique bit
390 the options-processing script will declare a @code{TARGET_@var{thisname}}
406 The option is an alias for @option{-@var{opt}} (or the negative form
409 @option{-@var{opt}}, and @option{-@var{opt}} is considered to be
412 considered to be passed as an argument to @option{-@var{opt}}.  In the
415 @option{-@var{opt}}, and if the alias is used in the negative form
416 then @var{negarg} is considered to be passed to @option{-@var{opt}}.
422 while those on the alias will be used to identify what command-line
432 considered to be an alias for the positive form of @option{-@var{opt}}
433 if negated and for the negative form of @option{-@var{opt}} if not
447 Java @option{-d} option and should not be used for new options.
458 The state of the option should be printed by @option{-fverbose-asm}.
462 @option{--help} output.  This flag does not currently affect anything
463 other than @option{--help}.
467 @option{--help} output, and any associated variable named using
472 This is an option that can be overridden on a per-function basis.
483 be included in the @option{--help} output.
490 the @option{--help} output.
499 @option{-ffast-math}.  This causes the @code{gcc_options} struct to
505 @option{-ffast-math} and @option{-fno-fast-math} from changing the
506 value of @option{-fmath-errno} for languages that do not use
513 @option{-@var{opt}}; multiple options can be given, separated by
516 and @var{opt2} must have the @code{Common} property; otherwise, use
522 of @option{-@var{opt}}, if not explicitly set. @var{opt} can be also a list
533 @option{-grecord-gcc-switches}.
541 option @var{var}.  If this property is set, then properties @code{Var}
547 C-family front-ends.