Re: [wwwdocs] gcc-15: Mention c++ header dependency changes () in porting_to.html

[Filip Kastl]

On Tue 2024-08-06 17:00:24, Gerald Pfeifer wrote:
> > +<p>
> > +The following headers are used less widely in libstdc++ and may need to
> > +be included explicitly when compiling with GCC 15:
> > +<ul>
> > +<li> <code>&lt;cstdint&gt;</code>
> > +  (for <code>std::int8_t</code>, <code>std::int32_t</code> etc.)
> > +</li>
> 
> The text reads "headers", alas there only appears to be one right now?
> So "header is" (singular)?

Nice catch.  I didn't notice this plural/singular mismatch.  Hmm, I could do
this:

<p>Some C++ Standard Library headers have been changed to no longer include
other headers that were being used internally by the library.
As such, C++ programs that used standard library components without
including the right headers will no longer compile.
</p>
<p>
In particular, the following header is used less widely in libstdc++ and may
need to be included explicitly when compiling with GCC 15:
</p>
<ul>
<li> <code>&lt;cstdint&gt;</code>
  (for <code>std::int8_t</code>, <code>std::int32_t</code> etc.)
</li>
</ul>

Here I only change the second paragraph.  The logic behind this is that the
first paragraph introduces the problem, therefore speaks more generally and
uses plural.  Then the second paragraph speaks about the particular header in
question and uses singular.

Or I could do this:

<p>Some C++ Standard Library headers have been changed to no longer include the
<code>&lt;cstdint&gt;</code>/<code>&lt;stdint.h&gt;</code> header that was
being used internally by the library. As such, C++ programs that used standard
library components without including <code>&lt;cstdint&gt;</code> where needed
will no longer compile.
</p>

<!-- Switch to this formulation if there are more headers like this
<p>Some C++ Standard Library headers have been changed to no longer include
other headers that were being used internally by the library.
As such, C++ programs that used standard library components without
including the right headers will no longer compile.
</p>
<p>
The following headers are used less widely in libstdc++ and may need to
be included explicitly when compiling with GCC 15:
<ul>
<li> <code>&lt;cstdint&gt;</code>
  (for <code>std::int8_t</code>, <code>std::int32_t</code> etc.)
</li>
-->

Any opinion on these two options?

Cheers,
Filip Kastl