From 77b104859e6bc366202bafa2f0490aa8f05ba4a1 Mon Sep 17 00:00:00 2001 From: Richard Sandiford Date: Thu, 14 Apr 2011 11:52:17 +0000 Subject: [PATCH] options.texi (Negative): Explicitly mention that the Negative chain must be circular. gcc/ * doc/options.texi (Negative): Explicitly mention that the Negative chain must be circular. From-SVN: r172419 --- gcc/ChangeLog | 5 +++++ gcc/doc/options.texi | 7 +++++++ 2 files changed, 12 insertions(+) diff --git a/gcc/ChangeLog b/gcc/ChangeLog index 0aa3fab8086..a0c881d445d 100644 --- a/gcc/ChangeLog +++ b/gcc/ChangeLog @@ -1,3 +1,8 @@ +2011-04-14 Richard Sandiford + + * doc/options.texi (Negative): Explicitly mention that the + Negative chain must be circular. + 2011-04-14 Nathan Froyd * function.h (block_chainon): Declare. diff --git a/gcc/doc/options.texi b/gcc/doc/options.texi index 69e73645893..edab7a9da66 100644 --- a/gcc/doc/options.texi +++ b/gcc/doc/options.texi @@ -222,6 +222,13 @@ the option name with the leading ``-'' removed. This chain action will propagate through the @code{Negative} property of the option to be turned off. +As a consequence, if you have a group of mutually-exclusive +options, their @code{Negative} properties should form a circular chain. +For example, if options @option{-@var{a}}, @option{-@var{b}} and +@option{-@var{c}} are mutually exclusive, their respective @code{Negative} +properties should be @samp{Negative(@var{b})}, @samp{Negative(@var{c})} +and @samp{Negative(@var{a})}. + @item Joined @itemx Separate The option takes a mandatory argument. @code{Joined} indicates -- 2.30.2