[PATCH] Update libstdc++ API Evolution documentation
Jonathan Wakely
jwakely@redhat.com
Tue Mar 19 09:38:00 GMT 2019
* doc/xml/manual/allocator.xml: Link to table documenting evolution
of extension allocators.
* doc/xml/manual/evolution.xml: Use angle brackets for header names.
Document new headers in 7.2, 8.1 and 9.1 releases.
* doc/xml/manual/using.xml: Adjust link target for new_allocator.
* doc/html/*: Regenerate.
Committed to trunk.
-------------- next part --------------
commit 2afabb199008ad0196de9d2c5c775efcffcb7782
Author: Jonathan Wakely <jwakely@redhat.com>
Date: Tue Mar 19 09:24:12 2019 +0000
Update libstdc++ API Evolution documentation
* doc/xml/manual/allocator.xml: Link to table documenting evolution
of extension allocators.
* doc/xml/manual/evolution.xml: Use angle brackets for header names.
Document new headers in 7.2, 8.1 and 9.1 releases.
* doc/xml/manual/using.xml: Adjust link target for new_allocator.
* doc/html/*: Regenerate.
diff --git a/libstdc++-v3/doc/xml/manual/allocator.xml b/libstdc++-v3/doc/xml/manual/allocator.xml
index 93d5c4a30f4..8d49b919ff6 100644
--- a/libstdc++-v3/doc/xml/manual/allocator.xml
+++ b/libstdc++-v3/doc/xml/manual/allocator.xml
@@ -138,7 +138,6 @@
<section xml:id="allocator.interface"><info><title>Interface Design</title></info>
-
<para>
The only allocator interface that
@@ -162,7 +161,6 @@
</section>
<section xml:id="allocator.default"><info><title>Selecting Default Allocation Policy</title></info>
-
<para>
It's difficult to pick an allocation strategy that will provide
@@ -228,7 +226,6 @@
</section>
<section xml:id="allocator.caching"><info><title>Disabling Memory Caching</title></info>
-
<para>
In use, <classname>allocator</classname> may allocate and
@@ -328,8 +325,8 @@
names have changed, but in all cases, functionality is
equivalent. Starting with gcc-3.4, all extension allocators are
standard style. Before this point, SGI style was the norm. Because of
- this, the number of template arguments also changed. Here's a simple
- chart to track the changes.
+ this, the number of template arguments also changed.
+ <xref linkend="table.extension_allocators"/> tracks the changes.
</para>
<para>
@@ -468,7 +465,7 @@
<para>
A high-performance fixed-size allocator with
exponentially-increasing allocations. It has its own
- <link linkend="manual.ext.allocator.mt">chapter</link>
+ <link linkend="manual.ext.allocator.mt">chapter</link>
in the documentation.
</para>
</listitem>
diff --git a/libstdc++-v3/doc/xml/manual/evolution.xml b/libstdc++-v3/doc/xml/manual/evolution.xml
index 3288e2f6cf2..e24418fefc0 100644
--- a/libstdc++-v3/doc/xml/manual/evolution.xml
+++ b/libstdc++-v3/doc/xml/manual/evolution.xml
@@ -13,7 +13,6 @@
</info>
-
<para>
A list of user-visible changes, in chronological order
</para>
@@ -33,9 +32,9 @@ is added that notifies on inclusion (<literal>-Wno-deprecated</literal>
deactivates the warning.)
</para>
-<para>Deprecated include <filename class="headerfile">backward/strstream</filename> added.</para>
+<para>Deprecated include <filename class="headerfile"><backward/strstream></filename> added.</para>
-<para>Removal of include <filename class="headerfile">builtinbuf.h</filename>, <filename class="headerfile">indstream.h</filename>, <filename class="headerfile">parsestream.h</filename>, <filename class="headerfile">PlotFile.h</filename>, <filename class="headerfile">SFile.h</filename>, <filename class="headerfile">stdiostream.h</filename>, and <filename class="headerfile">stream.h</filename>.
+<para>Removal of include <filename class="headerfile"><builtinbuf.h></filename>, <filename class="headerfile"><indstream.h></filename>, <filename class="headerfile"><parsestream.h></filename>, <filename class="headerfile"><PlotFile.h></filename>, <filename class="headerfile"><SFile.h></filename>, <filename class="headerfile"><stdiostream.h></filename>, and <filename class="headerfile"><stream.h></filename>.
</para>
@@ -51,7 +50,7 @@ deactivates the warning.)
Extensions from SGI/HP moved from <code>namespace std</code>
to <code>namespace __gnu_cxx</code>. As part of this, the following
new includes are
-added: <filename class="headerfile">ext/algorithm</filename>, <filename class="headerfile">ext/functional</filename>, <filename class="headerfile">ext/iterator</filename>, <filename class="headerfile">ext/memory</filename>, and <filename class="headerfile">ext/numeric</filename>.
+added: <filename class="headerfile"><ext/algorithm></filename>, <filename class="headerfile"><ext/functional></filename>, <filename class="headerfile"><ext/iterator></filename>, <filename class="headerfile"><ext/memory></filename>, and <filename class="headerfile"><ext/numeric></filename>.
</para>
<para>
@@ -59,11 +58,11 @@ Extensions to <code>basic_filebuf</code> introduced: <code>__gnu_cxx::enc_filebu
</para>
<para>
-Extensions to tree data structures added in <filename class="headerfile">ext/rb_tree</filename>.
+Extensions to tree data structures added in <filename class="headerfile"><ext/rb_tree></filename>.
</para>
<para>
-Removal of <filename class="headerfile">ext/tree</filename>, moved to <filename class="headerfile">backward/tree.h</filename>.
+Removal of <filename class="headerfile"><ext/tree></filename>, moved to <filename class="headerfile"><backward/tree.h></filename>.
</para>
</section>
@@ -74,7 +73,7 @@ Removal of <filename class="headerfile">ext/tree</filename>, moved to <filename
</para>
<para>Symbol versioning introduced for shared library.</para>
-<para>Removal of include <filename class="headerfile">backward/strstream.h</filename>.</para>
+<para>Removal of include <filename class="headerfile"><backward/strstream.h></filename>.</para>
<para>Allocator changes. Change <code>__malloc_alloc</code> to <code>malloc_allocator</code> and <code>__new_alloc</code> to <code>new_allocator</code>. </para>
@@ -109,7 +108,7 @@ Removal of <filename class="headerfile">ext/tree</filename>, moved to <filename
Large file support.
</para>
-<para> Extensions for generic characters and <code>char_traits</code> added in <filename class="headerfile">ext/pod_char_traits.h</filename>.
+<para> Extensions for generic characters and <code>char_traits</code> added in <filename class="headerfile"><ext/pod_char_traits.h></filename>.
</para>
<para>
@@ -123,7 +122,7 @@ Support for <code>char_traits</code> beyond builtin types.
<para>
Conformant <code>allocator</code> class and usage in containers. As
part of this, the following extensions are
-added: <filename class="headerfile">ext/bitmap_allocator.h</filename>, <filename class="headerfile">ext/debug_allocator.h</filename>, <filename class="headerfile">ext/mt_allocator.h</filename>, <filename class="headerfile">ext/malloc_allocator.h</filename>,<filename class="headerfile">ext/new_allocator.h</filename>, <filename class="headerfile">ext/pool_allocator.h</filename>.
+added: <filename class="headerfile"><ext/bitmap_allocator.h></filename>, <filename class="headerfile"><ext/debug_allocator.h></filename>, <filename class="headerfile"><ext/mt_allocator.h></filename>, <filename class="headerfile"><ext/malloc_allocator.h></filename>,<filename class="headerfile"><ext/new_allocator.h></filename>, <filename class="headerfile"><ext/pool_allocator.h></filename>.
</para>
<para>
@@ -186,37 +185,37 @@ _Alloc_traits</code> have been removed.
<tbody>
<row>
<entry><classname>__gnu_cxx::new_allocator<T></classname></entry>
- <entry><filename class="headerfile">ext/new_allocator.h</filename></entry>
+ <entry><filename class="headerfile"><ext/new_allocator.h></filename></entry>
<entry><classname>std::__new_alloc</classname></entry>
- <entry><filename class="headerfile">memory</filename></entry>
+ <entry><filename class="headerfile"><memory></filename></entry>
</row>
<row>
<entry><classname>__gnu_cxx::malloc_allocator<T></classname></entry>
- <entry><filename class="headerfile">ext/malloc_allocator.h</filename></entry>
+ <entry><filename class="headerfile"><ext/malloc_allocator.h></filename></entry>
<entry><classname>std::__malloc_alloc_template<int></classname></entry>
- <entry><filename class="headerfile">memory</filename></entry>
+ <entry><filename class="headerfile"><memory></filename></entry>
</row>
<row>
<entry><classname>__gnu_cxx::debug_allocator<T></classname></entry>
- <entry><filename class="headerfile">ext/debug_allocator.h</filename></entry>
+ <entry><filename class="headerfile"><ext/debug_allocator.h></filename></entry>
<entry><classname>std::debug_alloc<T></classname></entry>
- <entry><filename class="headerfile">memory</filename></entry>
+ <entry><filename class="headerfile"><memory></filename></entry>
</row>
<row>
<entry><classname>__gnu_cxx::__pool_alloc<T></classname></entry>
- <entry><filename class="headerfile">ext/pool_allocator.h</filename></entry>
+ <entry><filename class="headerfile"><ext/pool_allocator.h></filename></entry>
<entry><classname>std::__default_alloc_template<bool,int></classname></entry>
- <entry><filename class="headerfile">memory</filename></entry>
+ <entry><filename class="headerfile"><memory></filename></entry>
</row>
<row>
<entry><classname>__gnu_cxx::__mt_alloc<T></classname></entry>
- <entry><filename class="headerfile">ext/mt_allocator.h</filename></entry>
+ <entry><filename class="headerfile"><ext/mt_allocator.h></filename></entry>
<entry> </entry>
<entry> </entry>
</row>
<row>
<entry><classname>__gnu_cxx::bitmap_allocator<T></classname></entry>
- <entry><filename class="headerfile">ext/bitmap_allocator.h</filename></entry>
+ <entry><filename class="headerfile"><ext/bitmap_allocator.h></filename></entry>
<entry> </entry>
<entry> </entry>
</row>
@@ -249,12 +248,12 @@ _Alloc_traits</code> have been removed.
<tbody>
<row>
<entry><classname>__gnu_cxx::array_allocator<T></classname></entry>
- <entry><filename class="headerfile">ext/array_allocator.h</filename></entry>
+ <entry><filename class="headerfile"><ext/array_allocator.h></filename></entry>
<entry>4.0.0</entry>
</row>
<row>
<entry><classname>__gnu_cxx::throw_allocator<T></classname></entry>
- <entry><filename class="headerfile">ext/throw_allocator.h</filename></entry>
+ <entry><filename class="headerfile"><ext/throw_allocator.h></filename></entry>
<entry>4.2.0</entry>
</row>
</tbody>
@@ -275,11 +274,11 @@ Macro guard for changed, from <literal>_GLIBCPP_</literal> to <literal>_GLIBCXX_
</para>
<para>
-Extension <filename class="headerfile">ext/stdio_sync_filebuf.h</filename> added.
+Extension <filename class="headerfile"><ext/stdio_sync_filebuf.h></filename> added.
</para>
<para>
-Extension <filename class="headerfile">ext/demangle.h</filename> added.
+Extension <filename class="headerfile"><ext/demangle.h></filename> added.
</para>
@@ -294,15 +293,15 @@ TR1 features first appear.
</para>
<para>
-Extension allocator <filename class="headerfile">ext/array_allocator.h</filename> added.
+Extension allocator <filename class="headerfile"><ext/array_allocator.h></filename> added.
</para>
<para>
-Extension <code>codecvt</code> specializations moved to <filename class="headerfile">ext/codecvt_specializations.h</filename>.
+Extension <code>codecvt</code> specializations moved to <filename class="headerfile"><ext/codecvt_specializations.h></filename>.
</para>
<para>
-Removal of <filename class="headerfile">ext/demangle.h</filename>.
+Removal of <filename class="headerfile"><ext/demangle.h></filename>.
</para>
@@ -315,7 +314,7 @@ Removal of <filename class="headerfile">ext/demangle.h</filename>.
<para>
-Removal of <filename class="headerfile">cassert</filename> from all standard headers: now has to be explicitly included for <code>std::assert</code> calls.
+Removal of <filename class="headerfile"><cassert></filename> from all standard headers: now has to be explicitly included for <code>std::assert</code> calls.
</para>
<para> Extensions for policy-based data structures first added. New includes,
@@ -324,10 +323,10 @@ types, namespace <code>pb_assoc</code>.
-<para> Extensions for typelists added in <filename class="headerfile">ext/typelist.h</filename>.
+<para> Extensions for typelists added in <filename class="headerfile"><ext/typelist.h></filename>.
</para>
-<para> Extension for policy-based <code>basic_string</code> first added: <code>__gnu_cxx::__versa_string</code> in <filename class="headerfile">ext/vstring.h</filename>.
+<para> Extension for policy-based <code>basic_string</code> first added: <code>__gnu_cxx::__versa_string</code> in <filename class="headerfile"><ext/vstring.h></filename>.
</para>
</section>
@@ -341,16 +340,16 @@ types, namespace <code>pb_assoc</code>.
<para> Default visibility attributes applied to <code>namespace std</code>. Support for <code>-fvisibility</code>.
</para>
-<para>TR1 <filename class="headerfile">random</filename>, <filename class="headerfile">complex</filename>, and C compatibility headers added.</para>
+<para>TR1 <filename class="headerfile"><random></filename>, <filename class="headerfile"><complex></filename>, and C compatibility headers added.</para>
<para> Extensions for concurrent programming consolidated
-into <filename class="headerfile">ext/concurrence.h</filename> and <filename class="headerfile">ext/atomicity.h</filename>,
+into <filename class="headerfile"><ext/concurrence.h></filename> and <filename class="headerfile"><ext/atomicity.h></filename>,
including change of namespace to <code>__gnu_cxx</code> in some
cases. Added types
include <code>_Lock_policy</code>, <code>__concurrence_lock_error</code>, <code>__concurrence_unlock_error</code>, <code>__mutex</code>, <code>__scoped_lock</code>.</para>
<para> Extensions for type traits consolidated
-into <filename class="headerfile">ext/type_traits.h</filename>. Additional traits are added
+into <filename class="headerfile"><ext/type_traits.h></filename>. Additional traits are added
(<code>__conditional_type</code>, <code>__enable_if</code>, others.)
</para>
@@ -362,8 +361,8 @@ types, namespace moved to <code>__pb_ds</code>.
std::__debug</code> and extensions in <code>namespace
__gnu_cxx::__debug</code>.</para>
-<para> Extensions added: <filename class="headerfile">ext/typelist.h</filename>
-and <filename class="headerfile">ext/throw_allocator.h</filename>.
+<para> Extensions added: <filename class="headerfile"><ext/typelist.h></filename>
+and <filename class="headerfile"><ext/throw_allocator.h></filename>.
</para>
</section>
@@ -378,7 +377,7 @@ and <filename class="headerfile">ext/throw_allocator.h</filename>.
C++0X features first appear.
</para>
-<para>TR1 <filename class="headerfile">regex</filename> and <filename class="headerfile">cmath</filename>'s mathematical special function added.
+<para>TR1 <filename class="headerfile"><regex></filename> and <filename class="headerfile"><cmath></filename>'s mathematical special function added.
</para>
<para>
@@ -388,23 +387,23 @@ Backward include edit.
<listitem>
<para>Removed</para>
<para>
-<filename class="headerfile">algobase.h</filename> <filename class="headerfile">algo.h</filename> <filename class="headerfile">alloc.h</filename> <filename class="headerfile">bvector.h</filename> <filename class="headerfile">complex.h</filename>
-<filename class="headerfile">defalloc.h</filename> <filename class="headerfile">deque.h</filename> <filename class="headerfile">fstream.h</filename> <filename class="headerfile">function.h</filename> <filename class="headerfile">hash_map.h</filename> <filename class="headerfile">hash_set.h</filename>
-<filename class="headerfile">hashtable.h</filename> <filename class="headerfile">heap.h</filename> <filename class="headerfile">iomanip.h</filename> <filename class="headerfile">iostream.h</filename> <filename class="headerfile">istream.h</filename> <filename class="headerfile">iterator.h</filename>
-<filename class="headerfile">list.h</filename> <filename class="headerfile">map.h</filename> <filename class="headerfile">multimap.h</filename> <filename class="headerfile">multiset.h</filename> <filename class="headerfile">new.h</filename> <filename class="headerfile">ostream.h</filename> <filename class="headerfile">pair.h</filename> <filename class="headerfile">queue.h</filename> <filename class="headerfile">rope.h</filename> <filename class="headerfile">set.h</filename> <filename class="headerfile">slist.h</filename> <filename class="headerfile">stack.h</filename> <filename class="headerfile">streambuf.h</filename> <filename class="headerfile">stream.h</filename> <filename class="headerfile">tempbuf.h</filename>
-<filename class="headerfile">tree.h</filename> <filename class="headerfile">vector.h</filename>
+<filename class="headerfile"><algobase.h></filename> <filename class="headerfile"><algo.h></filename> <filename class="headerfile"><alloc.h></filename> <filename class="headerfile"><bvector.h></filename> <filename class="headerfile"><complex.h></filename>
+<filename class="headerfile"><defalloc.h></filename> <filename class="headerfile"><deque.h></filename> <filename class="headerfile"><fstream.h></filename> <filename class="headerfile"><function.h></filename> <filename class="headerfile"><hash_map.h></filename> <filename class="headerfile"><hash_set.h></filename>
+<filename class="headerfile"><hashtable.h></filename> <filename class="headerfile"><heap.h></filename> <filename class="headerfile"><iomanip.h></filename> <filename class="headerfile"><iostream.h></filename> <filename class="headerfile"><istream.h></filename> <filename class="headerfile"><iterator.h></filename>
+<filename class="headerfile"><list.h></filename> <filename class="headerfile"><map.h></filename> <filename class="headerfile"><multimap.h></filename> <filename class="headerfile"><multiset.h></filename> <filename class="headerfile"><new.h></filename> <filename class="headerfile"><ostream.h></filename> <filename class="headerfile"><pair.h></filename> <filename class="headerfile"><queue.h></filename> <filename class="headerfile"><rope.h></filename> <filename class="headerfile"><set.h></filename> <filename class="headerfile"><slist.h></filename> <filename class="headerfile"><stack.h></filename> <filename class="headerfile"><streambuf.h></filename> <filename class="headerfile"><stream.h></filename> <filename class="headerfile"><tempbuf.h></filename>
+<filename class="headerfile"><tree.h></filename> <filename class="headerfile"><vector.h></filename>
</para>
</listitem>
<listitem>
<para>Added</para>
<para>
- <filename class="headerfile">hash_map</filename> and <filename class="headerfile">hash_set</filename>
+ <filename class="headerfile"><hash_map></filename> and <filename class="headerfile"><hash_set></filename>
</para>
</listitem>
<listitem>
<para>Added in C++11</para>
<para>
- <filename class="headerfile">auto_ptr.h</filename> and <filename class="headerfile">binders.h</filename>
+ <filename class="headerfile"><auto_ptr.h></filename> and <filename class="headerfile"><binders.h></filename>
</para>
</listitem>
@@ -415,29 +414,29 @@ Header dependency streamlining.
</para>
<itemizedlist>
- <listitem><para><filename class="headerfile">algorithm</filename> no longer includes <filename class="headerfile">climits</filename>, <filename class="headerfile">cstring</filename>, or <filename class="headerfile">iosfwd</filename> </para></listitem>
- <listitem><para><filename class="headerfile">bitset</filename> no longer includes <filename class="headerfile">istream</filename> or <filename class="headerfile">ostream</filename>, adds <filename class="headerfile">iosfwd</filename> </para></listitem>
- <listitem><para><filename class="headerfile">functional</filename> no longer includes <filename class="headerfile">cstddef</filename></para></listitem>
- <listitem><para><filename class="headerfile">iomanip</filename> no longer includes <filename class="headerfile">istream</filename>, <filename class="headerfile">istream</filename>, or <filename class="headerfile">functional</filename>, adds <filename class="headerfile">ioswd</filename> </para></listitem>
- <listitem><para><filename class="headerfile">numeric</filename> no longer includes <filename class="headerfile">iterator</filename></para></listitem>
- <listitem><para><filename class="headerfile">string</filename> no longer includes <filename class="headerfile">algorithm</filename> or <filename class="headerfile">memory</filename></para></listitem>
+ <listitem><para><filename class="headerfile"><algorithm></filename> no longer includes <filename class="headerfile"><climits></filename>, <filename class="headerfile"><cstring></filename>, or <filename class="headerfile"><iosfwd></filename> </para></listitem>
+ <listitem><para><filename class="headerfile"><bitset></filename> no longer includes <filename class="headerfile"><istream></filename> or <filename class="headerfile"><ostream></filename>, adds <filename class="headerfile"><iosfwd></filename> </para></listitem>
+ <listitem><para><filename class="headerfile"><functional></filename> no longer includes <filename class="headerfile"><cstddef></filename></para></listitem>
+ <listitem><para><filename class="headerfile"><iomanip></filename> no longer includes <filename class="headerfile"><istream></filename>, <filename class="headerfile"><istream></filename>, or <filename class="headerfile"><functional></filename>, adds <filename class="headerfile"><ioswd></filename> </para></listitem>
+ <listitem><para><filename class="headerfile"><numeric></filename> no longer includes <filename class="headerfile"><iterator></filename></para></listitem>
+ <listitem><para><filename class="headerfile"><string></filename> no longer includes <filename class="headerfile"><algorithm></filename> or <filename class="headerfile"><memory></filename></para></listitem>
- <listitem><para><filename class="headerfile">valarray</filename> no longer includes <filename class="headerfile">numeric</filename> or <filename class="headerfile">cstdlib</filename></para></listitem>
- <listitem><para><filename class="headerfile">tr1/hashtable</filename> no longer includes <filename class="headerfile">memory</filename> or <filename class="headerfile">functional</filename></para></listitem>
- <listitem><para><filename class="headerfile">tr1/memory</filename> no longer includes <filename class="headerfile">algorithm</filename></para></listitem>
- <listitem><para><filename class="headerfile">tr1/random</filename> no longer includes <filename class="headerfile">algorithm</filename> or <filename class="headerfile">fstream</filename></para></listitem>
+ <listitem><para><filename class="headerfile"><valarray></filename> no longer includes <filename class="headerfile"><numeric></filename> or <filename class="headerfile"><cstdlib></filename></para></listitem>
+ <listitem><para><filename class="headerfile"><tr1/hashtable></filename> no longer includes <filename class="headerfile"><memory></filename> or <filename class="headerfile"><functional></filename></para></listitem>
+ <listitem><para><filename class="headerfile"><tr1/memory></filename> no longer includes <filename class="headerfile"><algorithm></filename></para></listitem>
+ <listitem><para><filename class="headerfile"><tr1/random></filename> no longer includes <filename class="headerfile"><algorithm></filename> or <filename class="headerfile"><fstream></filename></para></listitem>
</itemizedlist>
<para>
-Debug mode for <filename class="headerfile">unordered_map</filename> and <filename class="headerfile">unordered_set</filename>.
+Debug mode for <filename class="headerfile"><unordered_map></filename> and <filename class="headerfile"><unordered_set></filename>.
</para>
<para>
Parallel mode first appears.
</para>
-<para>Variadic template implementations of items in <filename class="headerfile">tuple</filename> and
- <filename class="headerfile">functional</filename>.
+<para>Variadic template implementations of items in <filename class="headerfile"><tuple></filename> and
+ <filename class="headerfile"><functional></filename>.
</para>
<para>Default <code>what</code> implementations give more elaborate
@@ -472,14 +471,14 @@ C++0X features.
Added.
</para>
<para>
- <filename class="headerfile">atomic</filename>,
- <filename class="headerfile">chrono</filename>,
- <filename class="headerfile">condition_variable</filename>,
- <filename class="headerfile">forward_list</filename>,
- <filename class="headerfile">initializer_list</filename>,
- <filename class="headerfile">mutex</filename>,
- <filename class="headerfile">ratio</filename>,
- <filename class="headerfile">thread</filename>
+ <filename class="headerfile"><atomic></filename>,
+ <filename class="headerfile"><chrono></filename>,
+ <filename class="headerfile"><condition_variable></filename>,
+ <filename class="headerfile"><forward_list></filename>,
+ <filename class="headerfile"><initializer_list></filename>,
+ <filename class="headerfile"><mutex></filename>,
+ <filename class="headerfile"><ratio></filename>,
+ <filename class="headerfile"><thread></filename>
</para>
</listitem>
@@ -488,9 +487,9 @@ C++0X features.
Updated and improved.
</para>
<para>
- <filename class="headerfile">algorithm</filename>,
- <filename class="headerfile">system_error</filename>,
- <filename class="headerfile">type_traits</filename>
+ <filename class="headerfile"><algorithm></filename>,
+ <filename class="headerfile"><system_error></filename>,
+ <filename class="headerfile"><type_traits></filename>
</para>
</listitem>
@@ -558,8 +557,8 @@ local mutex.
</para>
<para> Extensions
-added: <filename class="headerfile">ext/pointer.h</filename>
-and <filename class="headerfile">ext/extptr_allocator.h</filename>. Support
+added: <filename class="headerfile"><ext/pointer.h></filename>
+and <filename class="headerfile"><ext/extptr_allocator.h></filename>. Support
for non-standard pointer types has been added
to <classname>vector</classname>
and <classname>forward_list</classname>.
@@ -581,9 +580,9 @@ C++0X features.
Added.
</para>
<para>
- <filename class="headerfile">functional</filename>,
- <filename class="headerfile">future</filename>,
- <filename class="headerfile">random</filename>
+ <filename class="headerfile"><functional></filename>,
+ <filename class="headerfile"><future></filename>,
+ <filename class="headerfile"><random></filename>
</para>
</listitem>
@@ -592,9 +591,9 @@ C++0X features.
Updated and improved.
</para>
<para>
- <filename class="headerfile">atomic</filename>,
- <filename class="headerfile">system_error</filename>,
- <filename class="headerfile">type_traits</filename>
+ <filename class="headerfile"><atomic></filename>,
+ <filename class="headerfile"><system_error></filename>,
+ <filename class="headerfile"><type_traits></filename>
</para>
</listitem>
@@ -623,11 +622,11 @@ Audit for application of function attributes nothrow, const, pure, and noreturn.
<para>
The default behavior for comparing typeinfo names changed, so
-in <filename class="headerfile">typeinfo</filename>, <literal>__GXX_MERGED_TYPEINFO_NAMES</literal>
+in <filename class="headerfile"><typeinfo></filename>, <literal>__GXX_MERGED_TYPEINFO_NAMES</literal>
now defaults to zero.
</para>
-<para> Extensions modified: <filename class="headerfile">ext/throw_allocator.h</filename>.
+<para> Extensions modified: <filename class="headerfile"><ext/throw_allocator.h></filename>.
</para>
</section>
@@ -639,7 +638,7 @@ now defaults to zero.
<para>
The library was updated to avoid including
- <filename class="headerfile">stddef.h</filename> in order
+ <filename class="headerfile"><stddef.h></filename> in order
to reduce namespace pollution.
</para>
@@ -669,7 +668,7 @@ now defaults to zero.
<para>
The library was updated to avoid including
- <filename class="headerfile">unistd.h</filename> in order
+ <filename class="headerfile"><unistd.h></filename> in order
to reduce namespace pollution.
</para>
@@ -819,6 +818,16 @@ now defaults to zero.
<para> Profile Mode was deprecated. </para>
+<section xml:id="api.rel_72"><info><title><constant>7.2</constant></title></info>
+
+<para>
+ Library Fundamentals TS header
+ <filename class="headerfile"><experimental/source_location></filename>
+ added.
+</para>
+
+</section>
+
<section xml:id="api.rel_73"><info><title><constant>7.3</constant></title></info>
<para>
@@ -839,9 +848,17 @@ now defaults to zero.
</para>
<para>
+ Improved experimental C++17 support. Headers
+ <filename class="headerfile"><charconv></filename> and
+ <filename class="headerfile"><filesystem></filename>.
Experimental implementation of the C++17 Filesystem library added.
</para>
+<para>
+ Experimental C++2a support
+ (<function>to_address</function> and <classname>endian</classname>).
+</para>
+
<para>
AddressSanitizer annotations added to <classname>std::vector</classname>
to detect out-of-range accesses to the unused capacity of a vector.
@@ -895,4 +912,38 @@ now defaults to zero.
</section>
+<section xml:id="api.rel_91"><info><title><constant>9</constant></title></info>
+
+<para>
+ C++17 header
+ <filename class="headerfile"><memory_resource></filename>
+ added.
+</para>
+
+<para>
+ Experimental C++2a support improved, with new headers
+ <filename class="headerfile"><bit></filename> and
+ <filename class="headerfile"><version></filename> added.
+ Support for new character type <type>char8_t</type> added
+ to <classname>char_traits</classname>, <classname>basic_string</classname>,
+ <classname>numeric_limits</classname>,
+ and relevant locale facets and type traits.
+</para>
+
+<para>
+ Experimental implementation of the Networking TS library added,
+ with new headers
+ <filename class="headerfile"><experimental/buffer></filename>,
+ <filename class="headerfile"><experimental/executor></filename>,
+ <filename class="headerfile"><experimental/internet></filename>,
+ <filename class="headerfile"><experimental/io_context></filename>,
+ <filename class="headerfile"><experimental/net></filename>,
+ <filename class="headerfile"><experimental/netfwd></filename>,
+ <filename class="headerfile"><experimental/socket></filename>,
+ and
+ <filename class="headerfile"><experimental/timer></filename>.
+</para>
+
+</section>
+
</section>
diff --git a/libstdc++-v3/doc/xml/manual/using.xml b/libstdc++-v3/doc/xml/manual/using.xml
index 7647e9b8dad..9e8fe0715a3 100644
--- a/libstdc++-v3/doc/xml/manual/using.xml
+++ b/libstdc++-v3/doc/xml/manual/using.xml
@@ -1192,7 +1192,7 @@ g++ -Winvalid-pch -I. -include stdc++.h -H -g -O2 hello.cc -o test.exe
enabled for
<classname>std::vector<T, std::allocator<T>></classname>
and only when <classname>std::allocator</classname> is derived from
- <link linkend="allocator.impl"><classname>new_allocator</classname>
+ <link linkend="allocator.ext"><classname>new_allocator</classname>
or <classname>malloc_allocator</classname></link>. The annotations
must be present on all vector operations or none, so this macro must
be defined to the same value for all translation units that create,
More information about the Libstdc++
mailing list