From fb5550a0683db88d534c2795b76e5e9dd9e7f06d Mon Sep 17 00:00:00 2001 From: Jonathan Wakely Date: Fri, 22 Mar 2019 20:57:35 +0000 Subject: [PATCH] Remove broken links from libstdc++ manual to Doxygen pages The Doxygen docs do not have stable URLs, so linking to specific pages doesn't work well. * doc/xml/manual/backwards_compatibility.xml: Remove link to Doxygen-generated pages with unstable URL. * doc/xml/manual/concurrency_extensions.xml: Likewise. * doc/xml/manual/extensions.xml: Likewise. * doc/xml/manual/parallel_mode.xml: Likewise. * doc/xml/manual/support.xml: Likewise. From-SVN: r269881 --- libstdc++-v3/ChangeLog | 7 +++++++ libstdc++-v3/doc/xml/manual/backwards_compatibility.xml | 5 +++-- libstdc++-v3/doc/xml/manual/concurrency_extensions.xml | 2 +- libstdc++-v3/doc/xml/manual/extensions.xml | 10 ++++++---- libstdc++-v3/doc/xml/manual/parallel_mode.xml | 4 ++-- libstdc++-v3/doc/xml/manual/support.xml | 4 ++-- 6 files changed, 21 insertions(+), 11 deletions(-) diff --git a/libstdc++-v3/ChangeLog b/libstdc++-v3/ChangeLog index 2a3021a..061ec7f 100644 --- a/libstdc++-v3/ChangeLog +++ b/libstdc++-v3/ChangeLog @@ -1,5 +1,12 @@ 2019-03-22 Jonathan Wakely + * doc/xml/manual/backwards_compatibility.xml: Remove link to + Doxygen-generated pages with unstable URL. + * doc/xml/manual/concurrency_extensions.xml: Likewise. + * doc/xml/manual/extensions.xml: Likewise. + * doc/xml/manual/parallel_mode.xml: Likewise. + * doc/xml/manual/support.xml: Likewise. + * include/bits/stl_algobase.h (__lg): Do arithmetic on type int to avoid -Wconversion warnings. diff --git a/libstdc++-v3/doc/xml/manual/backwards_compatibility.xml b/libstdc++-v3/doc/xml/manual/backwards_compatibility.xml index aa95f3e..8d97c21 100644 --- a/libstdc++-v3/doc/xml/manual/backwards_compatibility.xml +++ b/libstdc++-v3/doc/xml/manual/backwards_compatibility.xml @@ -761,8 +761,9 @@ No stream::attach(int fd) An extension is available that implements this. - <ext/stdio_filebuf.h> contains a derived class called - __gnu_cxx::stdio_filebuf. + <ext/stdio_filebuf.h> + contains a derived class called + __gnu_cxx::stdio_filebuf. This class can be constructed from a C FILE* or a file descriptor, and provides the fd() function. diff --git a/libstdc++-v3/doc/xml/manual/concurrency_extensions.xml b/libstdc++-v3/doc/xml/manual/concurrency_extensions.xml index cb79c20..663ae5e 100644 --- a/libstdc++-v3/doc/xml/manual/concurrency_extensions.xml +++ b/libstdc++-v3/doc/xml/manual/concurrency_extensions.xml @@ -290,7 +290,7 @@ the current host. In libstdc++ implementation files, Within libstdc++ sources, all calls to underlying thread functionality -use this layer. More detail as to the specific interface can be found in the source documentation. +use this layer. More detail as to the specific interface can be found in the source documentation. By design, the gthread layer is interoperable with the types, diff --git a/libstdc++-v3/doc/xml/manual/extensions.xml b/libstdc++-v3/doc/xml/manual/extensions.xml index 84a995a..8912e39 100644 --- a/libstdc++-v3/doc/xml/manual/extensions.xml +++ b/libstdc++-v3/doc/xml/manual/extensions.xml @@ -479,11 +479,13 @@ get_temporary_buffer(5, (int*)0); so if you perform any I/O directly, don't expect the library to be aware of it. - Beginning with 3.1, the extra filebuf constructor and + Beginning with 3.1, the extra + basic_filebuf constructor and the fd() function were removed from the standard - filebuf. Instead, <ext/stdio_filebuf.h> contains - a derived class called - __gnu_cxx::stdio_filebuf. + filebuf. Instead, + <ext/stdio_filebuf.h> + contains a derived class template called + __gnu_cxx::stdio_filebuf. This class can be constructed from a C FILE* or a file descriptor, and provides the fd() function. diff --git a/libstdc++-v3/doc/xml/manual/parallel_mode.xml b/libstdc++-v3/doc/xml/manual/parallel_mode.xml index abf63ca..60e2088 100644 --- a/libstdc++-v3/doc/xml/manual/parallel_mode.xml +++ b/libstdc++-v3/doc/xml/manual/parallel_mode.xml @@ -725,8 +725,8 @@ i. e. it is a singleton. It can be read and written by calling __gnu_parallel::_Settings::set, respectively. Please note that the first call return a const object, so direct manipulation is forbidden. -See - settings.h +See + <parallel/settings.h> for complete details. diff --git a/libstdc++-v3/doc/xml/manual/support.xml b/libstdc++-v3/doc/xml/manual/support.xml index 573869a..53f4fbc 100644 --- a/libstdc++-v3/doc/xml/manual/support.xml +++ b/libstdc++-v3/doc/xml/manual/support.xml @@ -97,8 +97,8 @@ The header limits defines traits classes to give access to various implementation defined-aspects of the fundamental types. The traits classes -- - fourteen in total -- are all specializations of the template class - numeric_limits, documented here + fourteen in total -- are all specializations of the class template + numeric_limits and defined as follows: -- 2.7.4