I don't know if this applies to other --help varieties, but in the Arm backend we have some 'internal' options which we don't want the user to be using. However, --help=target is still printing these out even though the manual suggests these should be suppressed. For example, in arm.opt we have: ; Set to the name of target architecture which is required for ; multilib linking. This option is undocumented because it ; should not be used by the users. mlibarch= Target RejectNegative JoinedOrMissing NoDWARFRecord DriverOnly Undocumented But the output of --help=target contains: -mlibarch= This option lacks documentation. Which is wrong. Is there something else that needs to be done to suppress this output?
Note the manual says for 'Undocumented' @item Undocumented The option is deliberately missing documentation and should not be included in the @option{--help} output.
This case is also wrong: mhard-float Target RejectNegative Alias(mfloat-abi=, hard) Undocumented produces: -mhard-float Same as -mfloat-abi=hard. Which, while not inaccurate, means that the output of the help command contains a lot of 'old/deprecated' options that we really want to suppress going forwards.
I can take a look at this.