https://gcc.gnu.org/bugzilla/show_bug.cgi?id=89915
--- Comment #6 from GCC Commits <cvs-commit at gcc dot gnu.org> --- The master branch has been updated by Sandra Loosemore <[email protected]>: https://gcc.gnu.org/g:f4a46581e4fa6281c25e571337e275c565997393 commit r16-7285-gf4a46581e4fa6281c25e571337e275c565997393 Author: Sandra Loosemore <[email protected]> Date: Sun Feb 1 02:17:31 2026 +0000 doc: Move parameter docs to the GCC internals manual [PR123245] [PR89915] There appears to be some consensus that parameter documentation should be moved from the GCC user manual to the internals manual. Aside from the explicit disclaimer that parameters are implementation details and subject to change, many of them are documented in pure "implementor-speak" using jargon that users are unlikely to be familiar with. This patch moves the documentation more or less as-is. I added some sectioning and a new index to make things easier to find, but I did not modify the parameter descriptions to correct even obvious grammar and markup issues. That will be addressed in a subsequent patch. There are several places in the user manual that make dangling reference to parameters controlling the behavior of user-visible options, in spite of the caveats elsewhere that parameters are internal and can't be relied on. There's also a separate patch for this. gcc/ChangeLog PR target/123245 PR translation/89915 * Makefile.in (TEXI_GCCINT_FILES): Add params.texi. * doc/gccint.texi (pa): New index. (Top): Add new Parameters and Parameters Index nodes to menu. Include params.texi. (Parameter Index): New. * doc/invoke.texi (Option Summary): Move --param from Optimization Options to Developer Options. (Optimization Options): Move parameter documentation to params.texi. (Developer Options): Add abbreviated discussion of --param here. (LoongArch Options): Move parameter documentation to params.texi. (RISC-V Options): Likewise. (RS/6000 and PowerPC Options): Likewise. * doc/params.texi: New file.
