On 1/27/26 09:44, Nina Dinka Ranns wrote:
Hi Sandra,
On Tue, 27 Jan 2026 at 16:14, Sandra Loosemore <[email protected]
<mailto:[email protected]>> wrote:
On 1/27/26 09:00, Iain Sandoe wrote:
> Hi Sandra,
>
>> On 27 Jan 2026, at 15:53, Sandra Loosemore
<[email protected] <mailto:[email protected]>> wrote:
>>
>> On 1/26/26 17:32, Iain Sandoe wrote:
>>> This implements the current working draft contracts including
>>> National Body comment resolutions decided at the Nov 2025 WG21
>>> meeting.
>>> Is version 4 OK for trunk?
>>> (I will need to tweak changelogs and update opt-urls before
>>> committing)
>>
>> Since I was CC'ed on these patches I looked through them for
documentation changes. I see new options being added, but no
documentation. :-(
>
> Huh? ..
> I went through and added them (before v2 ws done) .. something
must be amiss - I will double check later.
> thanks for checking
I took another look. There are some documentation changes, but they're
not listed in the ChangeLogs.
Also: please add each option to the option summary for the respective
section, and index both the positive and negative form of each option
(although it's only necessary to explicitly document one of them).
apologies, first time doing this. Can you please elaborate on what you
mean by "please add each option to the option summary for the respective
section" ? If you point me to an example of things done right, that
would be very helpful.
In invoke.texi, there is a section called "Option Summary" that just
lists the option names. E.g. this is what the formatted output looks
like in the GCC 15 manual:
https://gcc.gnu.org/onlinedocs/gcc-15.2.0/gcc/Option-Summary.html
You want to add your new C++ options to the table for "C++ Language
Options" in addition to documenting them full in the "C++ Language
Options" section. Please list only the positive forms of the options in
the summary. If you put multiple options on the same line, separate
them by two spaces. Most of these lists are unfortunately not
consistently alphabetized or in any other discernible order; if that's
the case you can add them anywhere in the list, probably either at the
end or next to the same options where you put the full documentation.
For the full documentation, please index both positive and negative
forms, like
@opindex fwhatever
@opindex fno-whatever
@item -fwhatever
....
-Sandra
