diff mbox series

[wwwdocs] Document libstdc++ header dependency changes

Message ID 20201126113309.GA2103723@redhat.com
State New
Headers show
Series [wwwdocs] Document libstdc++ header dependency changes | expand

Commit Message

Jonathan Wakely Nov. 26, 2020, 11:33 a.m. UTC 
Also explain how to replace dynamic exception specifications.

Committed to wwwdocs.
commit 611da69f7782376d2737fe683f5db7ea7a5cdb31
Author: Jonathan Wakely <jwakely@redhat.com>
Date:   Thu Nov 26 11:31:02 2020 +0000

    Document libstdc++ header dependency changes
    
    Also explain how to replace dynamic exception specifications.

Comments

Jonathan Wakely Nov. 26, 2020, 11:53 a.m. UTC | #1 
On 26/11/20 11:33 +0000, Jonathan Wakely via Libstdc++ wrote:
>Also explain how to replace dynamic exception specifications.

And a small correction.

Committed to wwwdocs.
Gerald Pfeifer Dec. 1, 2020, 9:58 p.m. UTC | #2 
On Thu, 26 Nov 2020, Jonathan Wakely via Gcc-patches wrote:
>> Also explain how to replace dynamic exception specifications.
> And a small correction.

Ah, I was going to point that out. :-)

Let's see how many ports/packages the header cleanup is going to break 
this time.  Updating the default version of GCC in FreeBSD has proven a 
painful endeavour the last few times (though the GCC 10 update is mostly 
delayed due to stricter behavior on the Fortran side).

Cheers,
Gerald
Jeff Law Dec. 1, 2020, 10:06 p.m. UTC | #3 
On 12/1/20 2:58 PM, Gerald Pfeifer wrote:
> On Thu, 26 Nov 2020, Jonathan Wakely via Gcc-patches wrote:
>>> Also explain how to replace dynamic exception specifications.
>> And a small correction.
> Ah, I was going to point that out. :-)
>
> Let's see how many ports/packages the header cleanup is going to break 
> this time.  Updating the default version of GCC in FreeBSD has proven a 
> painful endeavour the last few times (though the GCC 10 update is mostly 
> delayed due to stricter behavior on the Fortran side).
I've already fixed ~100 in Fedora...  Those fixes are slowly trickling
to the appropriate upstreams.

Jeff
diff mbox series

Patch

diff --git a/htdocs/gcc-11/porting_to.html b/htdocs/gcc-11/porting_to.html
index 1e27064c..91cd0b4d 100644
--- a/htdocs/gcc-11/porting_to.html
+++ b/htdocs/gcc-11/porting_to.html
@@ -77,10 +77,43 @@  equality comparisons, not ordered comparisons.
 <p>
 GCC 11 defaults to C++17 which does not allow dynamic exception specifications.
 </p>
+<p>
+An exception specification like <code>throw(std::runtime_error)</code> should
+be removed or replaced with <code>noexcept(false)</code> (meaning the function
+can throw any type of exception).
+An exception specification like <code>throw()</code> can be replaced with
+<code>noexcept</code> or <code>noexcept(true)</code> (meaning the function
+does not throw exceptions).
+</p>
 
 <h3 id="Comparison-Functions">Comparison Functions</h3>
 <p>
 GCC 11 now enforces that comparison objects be invocable as const.
+</p>
+
+<h3 id="header-dep-changes">Header dependency changes</h3>
+<p>Some C++ Standard Library headers have been changed to no longer include
+other headers that they do need to depend on.
+As such, C++ programs that used standard library components without
+including the right headers will no longer compiler.
+</p>
+<p>
+The following headers are used less widely in libstdc++ and may need to
+be included explicitly by programs that were incorrectly relying on them
+being included implicitly by other headers:
+</p>
+<ul>
+<li> <code>&lt;limits&gt;</code>
+  (e.g. for <code>std::numeric_limits</code>)
+</li>
+<li> <code>&lt;memory&gt;</code>
+  (e.g. for <code>std::unique_ptr</code>, <code>std::shared_ptr</code> etc.)
+</li>
+<li> <code>&lt;utility&gt;</code>
+  (for <code>std::pair</code>, <code>std::tuple_size</code>,
+  <code>std::index_sequence</code> etc.)
+</li>
+</ul>
 
 <!--
 <h2 id="fortran">Fortran language issues</h2>