aboutsummaryrefslogtreecommitdiff
path: root/gcc/doc
diff options
context:
space:
mode:
authorJoseph Myers <joseph@codesourcery.com>2010-09-29 15:51:52 +0100
committerJoseph Myers <jsm28@gcc.gnu.org>2010-09-29 15:51:52 +0100
commitf0036cca42f0e15b89736429ffd17d174fa14f13 (patch)
treefee6c1797bd6ab1c8734c2276369a229a63e075c /gcc/doc
parente3339d0f3328e3bae21e460dde81ba4bdcfcd959 (diff)
downloadgcc-f0036cca42f0e15b89736429ffd17d174fa14f13.zip
gcc-f0036cca42f0e15b89736429ffd17d174fa14f13.tar.gz
gcc-f0036cca42f0e15b89736429ffd17d174fa14f13.tar.bz2
options.texi (Variable, Var, Init): Update documentation without reference to VarExists.
* doc/options.texi (Variable, Var, Init): Update documentation without reference to VarExists. (VarExists): Remove. * common.opt, config/i386/i386.opt, config/linux.opt, config/rs6000/rs6000.opt, config/sh/sh.opt, config/spu/spu.opt: Don't use VarExists. c-family: * c.opt: Don't use VarExists. fortran: * lang.opt: Don't use VarExists. java: * lang.opt: Don't use VarExists. From-SVN: r164724
Diffstat (limited to 'gcc/doc')
-rw-r--r--gcc/doc/options.texi27
1 files changed, 10 insertions, 17 deletions
diff --git a/gcc/doc/options.texi b/gcc/doc/options.texi
index 924ac17..d774b36 100644
--- a/gcc/doc/options.texi
+++ b/gcc/doc/options.texi
@@ -46,10 +46,10 @@ information. These records have two fields: the string
@samp{Variable}, and a declaration of the type and name of the
variable, optionally with an initializer (but without any trailing
@samp{;}). These records may be used for variables used for many
-options where declaring the variable and its initializer by omitting
-@code{VarExists} from a single option definition record would be
-inappropriate, or for variables set in option handlers rather than
-referenced by @code{Var} properties.
+options where declaring the initializer in a single option definition
+record, or duplicating it in many records, would be inappropriate, or
+for variables set in option handlers rather than referenced by
+@code{Var} properties.
@item
An option definition record. These records have the following fields:
@@ -177,7 +177,8 @@ compatibility with existing options that are used both directly and
via @option{-Wp,}; new options should not have this property.
@item Var(@var{var})
-The state of this option should be stored in variable @var{var}.
+The state of this option should be stored in variable @var{var}
+(actually a macro for @code{global_options.x_@var{var}}).
The way that the state is stored depends on the type of option:
@itemize @bullet
@@ -201,9 +202,8 @@ the argument string. The pointer will be null if the argument is optional
and wasn't given.
@end itemize
-The option-processing script will usually declare @var{var} in
-@file{options.c} and leave it to be zero-initialized at start-up time.
-You can modify this behavior using @code{VarExists} and @code{Init}.
+The option-processing script will usually zero-initialize @var{var}.
+You can modify this behavior using @code{Init}.
@item Var(@var{var}, @var{set})
The option controls an integer variable @var{var} and is active when
@@ -214,17 +214,10 @@ when the ``no-'' form is used.
@var{var} is declared in the same way as for the single-argument form
described above.
-@item VarExists
-The variable specified by the @code{Var} property already exists.
-No definition should be added to @file{options.c} in response to
-this option record.
-
-You should use this property only if the variable is declared outside
-@file{options.c}.
-
@item Init(@var{value})
The variable specified by the @code{Var} property should be statically
-initialized to @var{value}.
+initialized to @var{value}. If more than one option using the same
+variable specifies @code{Init}, all must specify the same initializer.
@item Mask(@var{name})
The option is associated with a bit in the @code{target_flags}