* 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.
commit 2afabb199008ad0196de9d2c5c775efcffcb7782
Author: Jonathan Wakely <[email protected]>
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,
