On Tue, 27 Jan 2026, Sandra Loosemore wrote: > BTW, having finally finished PR 122243, I have been intending to write up > something for the internals manual that says that all options should either > have documentation or be marked "Undocumented", along with the more specific > documentation conventions re indexing, listing in the option summary, etc. I > don't think this should be controversial.
Preferably undocumented options not marked as such should be detected by the testsuite (or earlier, causing a build failure); we've done a lot better at consistency of option --help text after the trailing '.' test was added to the testsuite. (Though it might be hard to check that e.g. a target option has documentation for that target rather than another target with a same-named option.) -- Joseph S. Myers [email protected]
