On 2/1/2026 9:05 PM, Sandra Loosemore wrote:
As the subject says. There have been discussions about moving the
parameter docs out of the user-facing documentation for some years
now. Aside from the explicit disclaimer about parameters being
unstable and subject to change, the existing documentation is of poor
quality and full of jargon and "implementor-speak" that is probably
incomprehensible to most users of GCC.
I'm not entirely certain I did the right thing in part 2 of the patch
series, by simply removing all dangling references to specific
parameters in other parts of the manual. I think it could be argued
that at least some of the affected parameters ought to be exposed to
users via "real" user-visible options that are aliased to the
parameters for backward compatibility. If anybody wants me to
undertake that instead, speak up! Otherwise I'll push this series in
a few days.
I suggest you push barring any objections. If there are params that
should be promoted to real user visible options, then we can tackle
those individually and construct sensible documentation for them at that
time.
Jeff
