> From: Sandra Loosemore <[email protected]> > Date: Wed, 19 Nov 2025 13:07:36 -0700
> This is another patch in the series to make documentation of > target-specific options in invoke.texi match what is in the > corresponding .opt files. > > The cris.opt file is a bit strange, with many cases where negative > forms are listed explicitly as separate options from the positive > forms, with both having "RejectNegative" and one (typically the form > that is the default) being marked as "Undocumented". I've left that > alone since fixing it to the more normal style of having a single > option setting a boolean flag would require code changes, and I'm not > set up to build or test this target. I'll not ask you to build it, but FWIW, it's a pretty standard *-elf" target, wrt. other required parts of the toolchain for testing; newlib, binutils, and sim. > Beyond that, the "Undocumented" status of options in the .opt file did > not in several cases match what was actually documented in the manual. > I've generally assumed that the manual is correct, and e.g. the > -m32-bit, -m16-bit, and -m8-bit options, all previously marked > "Undocumented" but listed in invoke.texi, are preferred to the > equivalent options without the hyphen. Sorry, but it's the other way round: the non-hyphenated form is preferable. The effect of Undocumented is not that I didn't want those options undocumented, but instead to nudge people to not use them; to not list them for --help target. If I had gone with your suggestions your changes would make sense, so I trust that you can reverse the hyphenated vs. no-hyphenated form change without separate approval, so "ok with that change". brgds, H-P
