doc: Mark more options as Undocumented/RejectNegative [PR122243]

In reviewing the autogenerated list of remaining undocumented options
after my first pass through the whole chapter, I found several more
options I'd previously overlooked that should either be marked
Undocumented, or that were missing a RejectNegative attribute where
one was plainly appropriate.

gcc/c-family/ChangeLog
	PR other/122243
	* c.opt (-output-pch): Mark as Undocumented, as it seems to be
	an internal option that has never been documented anyway.
	(Werror-implicit-function-declaration): Mark deprecated option
	that is not currently documented as Undocumented.
	(fconstant-string-class=): Add RejectNegative property.

gcc/ChangeLog
	PR other/122243
	* common.opt (fbounds-check): Mark as Undocumented, expand comments
	to explain why.
	* config/frv/frv.opt (msched-lookahead=): Mark unused option as
	Undocumented.
	* config/m68k/m68k.opt (m68851): Add RejectNegative.
	* config/nvptx/nvptx.opt (minit-regs=): Mark as Undocumented.  It's
	not currently documented and seems to have been introduced as a
	stopgap to experiment with different implementation strategies.
	* config/rs6000/476.opt (mpreserve-link-stack): Mark as Undocumented.
	It seems to be an internal option that is enabled by default on the
	cpu that can benefit from it.

diff --git a/gcc/c-family/c.opt b/gcc/c-family/c.opt
index e286c3b0535bb4e66607044b483eb46e683da521..a4065d685586bf253e074cd625ee332e33b120e7 100644 (file)
--- a/gcc/c-family/c.opt
+++ b/gcc/c-family/c.opt
@@ -149,8 +149,10 @@ C ObjC C++ ObjC++ Separate Alias(o)
 -output=
 C ObjC C++ ObjC++ Joined Alias(o)
 
+; The documented user option for PCH output is -o.  The driver converts that
+; to -output-pch when invoking the front ends to produce a PCH file.
 -output-pch
-C ObjC C++ ObjC++ Separate
+C ObjC C++ ObjC++ Separate Undocumented
 
 -pedantic
 C ObjC C++ ObjC++ Alias(pedantic)
@@ -758,7 +760,7 @@ C ObjC C++ ObjC++
 ; Documented in common.opt
 
 Werror-implicit-function-declaration
-C ObjC RejectNegative Warning Alias(Werror=, implicit-function-declaration)
+C ObjC RejectNegative Undocumented Warning Alias(Werror=, implicit-function-declaration)
 This switch is deprecated; use -Werror=implicit-function-declaration instead.
 
 Wexceptions
@@ -1875,7 +1877,7 @@ C++ ObjC++ Ignore
 Does nothing.  Preserved for backward compatibility.
 
 fconstant-string-class=
-ObjC ObjC++ Joined MissingArgError(no class name specified with %qs)
+ObjC ObjC++ Joined RejectNegative MissingArgError(no class name specified with %qs)
 -fconst-string-class=<name>    Use class <name> for constant strings.
 
 fconstexpr-depth=

diff --git a/gcc/common.opt b/gcc/common.opt
index 59b8efe541467c1d635f00324f48539c9ace11ba..4c73f51defac8f47091a37778fc458fc7cae3d92 100644 (file)
--- a/gcc/common.opt
+++ b/gcc/common.opt
@@ -1213,10 +1213,11 @@ Common Var(flag_auto_profile_inlining) Init(1) Optimization
 Perform inlining using auto-profile.
 
 ; -fbounds-check causes gcc to generate array bounds checks.
-; It's presently used only for fortran and d languages, and is documented
-; in the manuals for those languages.
+; It's presently used only for fortran, algol68, and d languages.
+; In Fortran and algol68 it is a deprecated alias for -fcheck=bounds,
+; in D it is documented in the D language manual.
 fbounds-check
-Common Var(flag_bounds_check)
+Common Undocumented Var(flag_bounds_check)
 Generate code to check bounds before indexing arrays.
 
 fbranch-count-reg

diff --git a/gcc/config/frv/frv.opt b/gcc/config/frv/frv.opt
index b9771a897fad240d3e316c57a9ebc5784e32c860..27e881d96a5698c0a2eeea4325a094abcf2297ca 100644 (file)
--- a/gcc/config/frv/frv.opt
+++ b/gcc/config/frv/frv.opt
@@ -206,8 +206,9 @@ mscc
 Target Mask(SCC)
 Enable setting GPRs to the result of comparisons.
 
+; This option seems not to be used anywhere.
 msched-lookahead=
-Target RejectNegative Joined UInteger Var(frv_sched_lookahead) Init(4)
+Target Undocumented RejectNegative Joined UInteger Var(frv_sched_lookahead) Init(4)
 Change the amount of scheduler lookahead.
 
 msoft-float

diff --git a/gcc/config/m68k/m68k.opt b/gcc/config/m68k/m68k.opt
index a97fac654d887481a0307e5d6b829200186ddbdf..7558ce1b9c7a6ddf8cbe1aeecbcddb5ef5b46bb3 100644 (file)
--- a/gcc/config/m68k/m68k.opt
+++ b/gcc/config/m68k/m68k.opt
@@ -87,7 +87,7 @@ Generate code for a 68332.
 
 ; Has no effect on gcc
 m68851
-Target
+Target RejectNegative
 Generate code for a 68851.
 
 m68881

diff --git a/gcc/config/nvptx/nvptx.opt b/gcc/config/nvptx/nvptx.opt
index 62a4fa464552c26cbac1c8a197e4464de33b5242..c3b128d3e04df255e247d07d72100f7880b711f2 100644 (file)
--- a/gcc/config/nvptx/nvptx.opt
+++ b/gcc/config/nvptx/nvptx.opt
@@ -204,7 +204,7 @@ Target RejectNegative Negative(mptx=) ToLower Joined Enum(ptx_version) Var(ptx_v
 Specify the PTX ISA version to use.
 
 minit-regs=
-Target Var(nvptx_init_regs) IntegerRange(0, 3) Joined UInteger Init(3)
+Target Undocumented Var(nvptx_init_regs) IntegerRange(0, 3) Joined UInteger Init(3)
 Initialize ptx registers.
 
 mptx-comment

diff --git a/gcc/config/rs6000/476.opt b/gcc/config/rs6000/476.opt
index ac3de91ff5b51bf6d67f025bb1387eb94d00bd93..43230a1466e2c64143beaa5da050d4f92d84bff5 100644 (file)
--- a/gcc/config/rs6000/476.opt
+++ b/gcc/config/rs6000/476.opt
@@ -20,5 +20,5 @@
 ; <http://www.gnu.org/licenses/>.
 
 mpreserve-link-stack
-Target Var(rs6000_link_stack) Init(-1) Save
+Target Undocumented Var(rs6000_link_stack) Init(-1) Save
 Preserve the PowerPC 476's link stack by matching up a blr with the bcl/bl insns used for GOT accesses.