summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorJonathan Wakely <jwakely@redhat.com>2023-05-15 21:41:56 +0100
committerJonathan Wakely <jwakely@redhat.com>2023-06-23 14:01:06 +0100
commit291df257830e4ff877c716cfe6430c03677d9606 (patch)
tree49ddef82f51c6db969eb957fa012493010e0a605
parentb272bc0fbf84454cae8c02e7404cfb23641380cd (diff)
libstdc++: Document removal of implicit allocator rebinding extensions
Traditionally libstdc++ allowed containers to be instantiated with allocator's that have the wrong value type, implicitly rebinding the allocator to the container's value type. Since C++20 that has been explicitly ill-formed, so the extension is no longer supported in strict modes (e.g. -std=c++17) and in C++20 and later. libstdc++-v3/ChangeLog: * doc/xml/manual/evolution.xml: Document removal of implicit allocator rebinding extensions in strict mode and for C++20. * doc/html/*: Regenerate. (cherry picked from commit 8cbaf679a3c1875c5475bd1cb0fb86fb9d03b2d4)
-rw-r--r--libstdc++-v3/doc/html/manual/api.html9
-rw-r--r--libstdc++-v3/doc/xml/manual/evolution.xml13
2 files changed, 22 insertions, 0 deletions
diff --git a/libstdc++-v3/doc/html/manual/api.html b/libstdc++-v3/doc/html/manual/api.html
index 359dcc4f213..8f0b17e858a 100644
--- a/libstdc++-v3/doc/html/manual/api.html
+++ b/libstdc++-v3/doc/html/manual/api.html
@@ -368,6 +368,11 @@ now defaults to zero.
For the non-default <code class="option">--enable-symvers=gnu-versioned-namespace</code>
configuration, the shared library SONAME has been changed to
<code class="filename">libstdc++.so.8</code>.
+</p><p>
+ The extension allowing containers to be instantiated with an allocator
+ that doesn't match the container's value type is no longer allowed in
+ strict (<code class="option">-std=c++NN</code>) modes, only in
+ <code class="option">-std=gnu++NN</code> modes.
</p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="api.rel_91"></a><code class="constant">9</code></h3></div></div></div><p>
C++17 header
<code class="filename">&lt;memory_resource&gt;</code>
@@ -423,4 +428,8 @@ now defaults to zero.
and
<code class="filename">&lt;stop_token&gt;</code>
added.
+</p><p>
+ The extension allowing containers to be instantiated with an allocator
+ that doesn't match the container's value type is no longer allowed in
+ C++20 mode, even in non-strict <code class="option">-std=gnu++20</code> mode.
</p></div></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="abi.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="appendix_porting.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="backwards.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">ABI Policy and Guidelines </td><td width="20%" align="center"><a accesskey="h" href="../index.html">Home</a></td><td width="40%" align="right" valign="top"> Backwards Compatibility</td></tr></table></div></body></html> \ No newline at end of file
diff --git a/libstdc++-v3/doc/xml/manual/evolution.xml b/libstdc++-v3/doc/xml/manual/evolution.xml
index 0394f7efb7b..f7bf8bb2b71 100644
--- a/libstdc++-v3/doc/xml/manual/evolution.xml
+++ b/libstdc++-v3/doc/xml/manual/evolution.xml
@@ -911,6 +911,13 @@ now defaults to zero.
<filename>libstdc++.so.8</filename>.
</para>
+<para>
+ The extension allowing containers to be instantiated with an allocator
+ that doesn't match the container's value type is no longer allowed in
+ strict (<option>-std=c++NN</option>) modes, only in
+ <option>-std=gnu++NN</option> modes.
+</para>
+
</section>
<section xml:id="api.rel_91"><info><title><constant>9</constant></title></info>
@@ -994,6 +1001,12 @@ now defaults to zero.
added.
</para>
+<para>
+ The extension allowing containers to be instantiated with an allocator
+ that doesn't match the container's value type is no longer allowed in
+ C++20 mode, even in non-strict <option>-std=gnu++20</option> mode.
+</para>
+
</section>
</section>