On Sat, Nov 8, 2025 at 9:54 PM Sandra Loosemore <[email protected]> wrote: > > We have a number of command-line options that are undocumented (either > intentionally or because they are obsolete and retained only for > compatibility), that ought to be marked as "Undocumented". I've also > added some comments to the .opt files.
OK. Thanks, Richard. > gcc/c-family/ChangeLog > PR other/122243 > * c.opt (fmodule-version-ignore): Mark as "Undocumented". > > gcc/ChangeLog > PR other/122243 > * common.opt (fhelp, fhelp=, ftarget-help, fversion): Mark as > "Undocumented". > (fbounds-check): Update comments. > (flag-graphite, fsel-sched-reschedule-pipelined): Mark as > "Undocumented". > (fstack-limit): Add comment. > --- > gcc/c-family/c.opt | 2 +- > gcc/common.opt | 21 +++++++++++---------- > 2 files changed, 12 insertions(+), 11 deletions(-) > > diff --git a/gcc/c-family/c.opt b/gcc/c-family/c.opt > index b8bdc2be6d5..0d97b0d13ce 100644 > --- a/gcc/c-family/c.opt > +++ b/gcc/c-family/c.opt > @@ -2122,7 +2122,7 @@ C++ ObjC++ Var(flag_module_lazy) Init(1) > Enable lazy module importing. > > fmodule-version-ignore > -C++ ObjC Var(flag_module_version_ignore) Integer > +C++ ObjC Var(flag_module_version_ignore) Integer Undocumented > ; undocumented, Very dangerous, but occasionally useful > > Winvalid-imported-macros > diff --git a/gcc/common.opt b/gcc/common.opt > index 2c8c0e44750..9cbd2d8a794 100644 > --- a/gcc/common.opt > +++ b/gcc/common.opt > @@ -426,16 +426,16 @@ Driver Alias(v) > ;; as -fhelp; the following four entries are for compatibility with > ;; any direct uses of those (undocumented) -f forms > fhelp > -Common Driver RejectNegative Alias(-help) > +Common Driver RejectNegative Alias(-help) Undocumented > > fhelp= > -Common Driver RejectNegative Joined Alias(-help=) > +Common Driver RejectNegative Joined Alias(-help=) Undocumented > > ftarget-help > -Common Driver RejectNegative Alias(-target-help) > +Common Driver RejectNegative Alias(-target-help) Undocumented > > fversion > -Common Driver RejectNegative Alias(-version) > +Common Driver RejectNegative Alias(-version) Undocumented > > -sysroot > Driver Separate Alias(-sysroot=) > @@ -1200,10 +1200,9 @@ fauto-profile-inlining > Common Var(flag_auto_profile_inlining) Init(1) Optimization > Perform inlining using auto-profile. > > -; -fcheck-bounds causes gcc to generate array bounds checks. > -; For C, C++ and ObjC: defaults off. > -; For Java: defaults to on. > -; For Fortran: defaults to off. > +; -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. > fbounds-check > Common Var(flag_bounds_check) > Generate code to check bounds before indexing arrays. > @@ -1861,7 +1860,7 @@ Common Enum(dwarf_gnat_encodings) Joined RejectNegative > Undocumented Var(gnat_en > > ; This option is not documented yet as its semantics will change. > fgraphite > -Common Var(flag_graphite) Optimization > +Common Var(flag_graphite) Optimization Undocumented > Enable in and out of Graphite representation. > > fgraphite-identity > @@ -2889,8 +2888,9 @@ fsel-sched-pipelining-outer-loops > Common Var(flag_sel_sched_pipelining_outer_loops) Init(0) Optimization > Perform software pipelining of outer loops during selective scheduling. > > +; This flag has never been documented or done anything useful AFAICT. > fsel-sched-reschedule-pipelined > -Common Var(flag_sel_sched_reschedule_pipelined) Init(0) Optimization > +Common Var(flag_sel_sched_reschedule_pipelined) Init(0) Optimization > Undocumented > Reschedule pipelined regions without pipelining. > > fsemantic-interposition > @@ -3029,6 +3029,7 @@ Common Var(flag_stack_clash_protection) Optimization > Insert code to probe each page of stack space as it is allocated to protect > from stack-clash style attacks. > > +; The real option is fno-stack-limit. > fstack-limit > Common Var(common_deferred_options) Defer > > -- > 2.39.5 >
