mbox series

[00/20] Second set of doc updates for target-specific options

Message ID 20251207001030.1024365-1-sloosemore@baylibre.com
Headers
Series Second set of doc updates for target-specific options |

Message

Sandra Loosemore Dec. 7, 2025, 12:10 a.m. UTC 
  Here's a second set of patches to clean up the documentation for
target-specific options.  As with the already-committed first set, my
focus here has been to try to get the .opt files, option summary, and
detailed option documentation in agreement; index both positive and
negative forms of the options; and only list one form in the summary.
I've also removed documentation for options already explicitly
identified as obsolete or deprecated in order to reduce unhelpful
verbosity in the manual.

This patch set also includes revised versions of the previously-posted
ARC and H8/300 patches.  In the interests of getting the documentation
cleanups in, I've un-done the .opt file changes I had in the previous
version of the patches for those targets, since I wasn't set up to
test them myself.

I'll hold off on committing these patches for a few days in case there
are comments from the target maintainers, and follow it up with a
"make regenerate-opt-urls" patch.

I plan at least one more batch of patches in this series to handle the
options for the remaining targets in the manual.

-Sandra


Sandra Loosemore (20):
  doc, arc: Clean up ARC option documentation [PR122243]
  doc, h8300: Clean up H8/300 option and attribute documentation
    [PR122243]
  doc, pa: HPPA option documentation cleanup  [PR122243]
  doc, ia64: Clean up documentation of IA-64 options [PR122243]
  doc, lm32: Clean up LM32 option documentation [PR122243]
  doc, loongarch: Clean up LoongArch option documentation [PR122243]
  doc, m32c: Clean up M32C option documentation [PR122243]
  doc, m32r: Clean up documentation of M32R/D options [PR122243]
  doc, m68k: Clean up M680x0 option documentation [PR122243] [PR119404]
  doc, mcore: Clean up MCore option documentation [PR122243]
  doc, microblaze: Clean up MicroBlaze option documentation [PR122243]
  doc, mips: Clean up MIPS option documentation [PR122243]
  doc, mmix: Clean up MMIX option documentation [PR122243]
  doc, mn10300: Clean up MN10300 option documentation [PR122243]
  doc, msp430: Clean up MSP430 option documentation [PR122243]
  doc, nds32: Clean up NDS32 option documentation [PR122243]
  doc, nvptx: Clean up documentation of Nvidia PDX Options [PR122243]
  doc, or1k: Clean up OpenRISC option documentation [PR122243]
  doc, pdp11: Clean up PDP-11 documentation [PR122243]
  doc, pru: Clean up PRU option documentation [PR122243]

 gcc/config/arc/arc.opt               |   60 +-
 gcc/config/h8300/h8300.opt           |    2 +
 gcc/config/ia64/ia64.opt             |    4 +-
 gcc/config/m68k/m68k.opt             |    2 +-
 gcc/config/microblaze/microblaze.opt |   24 +-
 gcc/config/mips/mips.opt             |    4 +-
 gcc/config/msp430/msp430.opt         |    4 +-
 gcc/config/or1k/elf.opt              |    2 +-
 gcc/config/or1k/or1k.opt             |    6 +-
 gcc/config/pa/pa.opt                 |   10 +-
 gcc/doc/extend.texi                  |   12 +
 gcc/doc/invoke.texi                  | 1106 ++++++++++++--------------
 12 files changed, 602 insertions(+), 634 deletions(-)