diff options
author | Jonathan Wakely <jwakely@redhat.com> | 2023-05-15 21:41:56 +0100 |
---|---|---|
committer | Jonathan Wakely <jwakely@redhat.com> | 2023-06-01 16:04:26 +0100 |
commit | 8cbaf679a3c1875c5475bd1cb0fb86fb9d03b2d4 (patch) | |
tree | 49d14b555e84d1c0e42abefbc6396cf281736137 /libstdc++-v3/doc | |
parent | dec7aaabe9651cb075ace60721b6e36864cc5140 (diff) | |
download | gcc-8cbaf679a3c1875c5475bd1cb0fb86fb9d03b2d4.zip gcc-8cbaf679a3c1875c5475bd1cb0fb86fb9d03b2d4.tar.gz gcc-8cbaf679a3c1875c5475bd1cb0fb86fb9d03b2d4.tar.bz2 |
libstdc++: Document removal of implicit allocator rebinding extensions
Traditionally libstdc++ allowed containers and strings 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.
Diffstat (limited to 'libstdc++-v3/doc')
-rw-r--r-- | libstdc++-v3/doc/html/manual/api.html | 13 | ||||
-rw-r--r-- | libstdc++-v3/doc/xml/manual/evolution.xml | 19 |
2 files changed, 32 insertions, 0 deletions
diff --git a/libstdc++-v3/doc/html/manual/api.html b/libstdc++-v3/doc/html/manual/api.html index 7d5f754..27c0d09 100644 --- a/libstdc++-v3/doc/html/manual/api.html +++ b/libstdc++-v3/doc/html/manual/api.html @@ -370,6 +370,11 @@ Calling a <code class="code">std::bind</code> result as volatile was deprecated 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"><memory_resource></code> @@ -425,6 +430,10 @@ Calling a <code class="code">std::bind</code> result as volatile was deprecated and <code class="filename"><stop_token></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 class="section"><div class="titlepage"><div><div><h3 class="title"><a id="api.rel_111"></a><code class="constant">11</code></h3></div></div></div><p> The <code class="option">--enable-cheaders=c_std</code> configuration was deprecated. @@ -479,4 +488,8 @@ Tunables <span style="color: red"><variable>glibcxx.eh_pool.obj_count</ </p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="api.rel_141"></a><code class="constant">14</code></h3></div></div></div><p> Deprecate the non-standard overload that allows <code class="code">std::setfill</code> to be used with <code class="code">std::basic_istream</code>. +</p><p> + The extension allowing <code class="code">std::basic_string</code> to be instantiated + with an allocator that doesn't match the string's character type is no + longer allowed in C++20 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 4037a18..db70f24 100644 --- a/libstdc++-v3/doc/xml/manual/evolution.xml +++ b/libstdc++-v3/doc/xml/manual/evolution.xml @@ -915,6 +915,13 @@ Calling a <code>std::bind</code> result as volatile was deprecated for C++17. <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> @@ -998,6 +1005,12 @@ Calling a <code>std::bind</code> result as volatile was deprecated for C++17. 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 xml:id="api.rel_111"><info><title><constant>11</constant></title></info> @@ -1096,6 +1109,12 @@ Deprecate the non-standard overload that allows <code>std::setfill</code> to be used with <code>std::basic_istream</code>. </para> +<para> + The extension allowing <code>std::basic_string</code> to be instantiated + with an allocator that doesn't match the string's character type is no + longer allowed in C++20 mode. +</para> + </section> </section> |