From 393ed575c4a713b7e73f5f963f728b78893e7d8d Mon Sep 17 00:00:00 2001 From: Jonathan Wakely Date: Thu, 23 Mar 2017 19:40:21 +0000 Subject: [PATCH] Fix broken links in manual and remove outdated info * doc/xml/faq.xml: Add link. * doc/xml/manual/backwards_compatibility.xml: Remove outdated information on pre-ISO headers. Replace broken link to C++ FAQ Lite. * doc/xml/manual/io.xml: Update broken link. * doc/html/*: Regenerate. From-SVN: r246425 --- libstdc++-v3/ChangeLog | 8 +++ libstdc++-v3/doc/html/faq.html | 19 +----- libstdc++-v3/doc/html/index.html | 2 +- libstdc++-v3/doc/html/manual/appendix.html | 2 +- .../doc/html/manual/appendix_contributing.html | 6 +- libstdc++-v3/doc/html/manual/appendix_porting.html | 2 +- libstdc++-v3/doc/html/manual/backwards.html | 72 ++------------------- libstdc++-v3/doc/html/manual/index.html | 2 +- libstdc++-v3/doc/html/manual/status.html | 12 ++-- libstdc++-v3/doc/html/manual/streambufs.html | 7 +- .../doc/html/manual/using_concurrency.html | 2 +- libstdc++-v3/doc/xml/faq.xml | 3 +- .../doc/xml/manual/backwards_compatibility.xml | 75 ++-------------------- libstdc++-v3/doc/xml/manual/io.xml | 7 +- libstdc++-v3/doc/xml/manual/using.xml | 2 +- 15 files changed, 46 insertions(+), 175 deletions(-) diff --git a/libstdc++-v3/ChangeLog b/libstdc++-v3/ChangeLog index 1425d28..e5ffec5 100644 --- a/libstdc++-v3/ChangeLog +++ b/libstdc++-v3/ChangeLog @@ -1,3 +1,11 @@ +2017-03-23 Jonathan Wakely + + * doc/xml/faq.xml: Add link. + * doc/xml/manual/backwards_compatibility.xml: Remove outdated + information on pre-ISO headers. Replace broken link to C++ FAQ Lite. + * doc/xml/manual/io.xml: Update broken link. + * doc/html/*: Regenerate. + 2017-03-23 Daniel Kruegler Implement LWG 2686, Why is std::hash specialized for error_code, diff --git a/libstdc++-v3/doc/html/faq.html b/libstdc++-v3/doc/html/faq.html index d8695cd..4e0faba 100644 --- a/libstdc++-v3/doc/html/faq.html +++ b/libstdc++-v3/doc/html/faq.html @@ -821,23 +821,8 @@ page.

7.6.

How do I get a copy of the ISO C++ Standard?

- Copies of the full ISO 14882 standard are available on line via - the ISO mirror site for committee members. Non-members, or those - who have not paid for the privilege of sitting on the committee - and sustained their two-meeting commitment for voting rights, may - get a copy of the standard from their respective national - standards organization. In the USA, this national standards - organization is ANSI and their website is - right here. (And if - you've already registered with them, clicking this link will take - you to directly to the place where you can - buy the standard on-line. -

- Who is your country's member body? Visit the - ISO homepage and find out! -

- The 2003 version of the standard (the 1998 version plus TC1) is - available in print, ISBN 0-470-84674-7. + Please refer to the Contributing + section in our manual.

7.7.

What's an ABI and why is it so messy?

diff --git a/libstdc++-v3/doc/html/index.html b/libstdc++-v3/doc/html/index.html index 1466567..15dc624 100644 --- a/libstdc++-v3/doc/html/index.html +++ b/libstdc++-v3/doc/html/index.html @@ -146,7 +146,7 @@ C++11 Requirements Test Sequence Descriptions

No vector::at, deque::at, string::at
No std::char_traits<char>::eof
No string::clear
Removal of ostream::form and istream::scan extensions -
No basic_stringbuf, basic_stringstream
Little or no wide character support
No templatized iostreams
Thread safety issues
Third
Pre-ISO headers moved to backwards or removed
Extension headers hash_map, hash_set moved to ext or backwards
No ios::nocreate/ios::noreplace. +
No basic_stringbuf, basic_stringstream
Little or no wide character support
No templatized iostreams
Thread safety issues
Third
Pre-ISO headers removed
Extension headers hash_map, hash_set moved to ext or backwards
No ios::nocreate/ios::noreplace.
No stream::attach(int fd)
diff --git a/libstdc++-v3/doc/html/manual/appendix.html b/libstdc++-v3/doc/html/manual/appendix.html index 175c879..b190d7b 100644 --- a/libstdc++-v3/doc/html/manual/appendix.html +++ b/libstdc++-v3/doc/html/manual/appendix.html @@ -20,7 +20,7 @@ C++11 Requirements Test Sequence Descriptions
No vector::at, deque::at, string::at
No std::char_traits<char>::eof
No string::clear
Removal of ostream::form and istream::scan extensions -
No basic_stringbuf, basic_stringstream
Little or no wide character support
No templatized iostreams
Thread safety issues
Third
Pre-ISO headers moved to backwards or removed
Extension headers hash_map, hash_set moved to ext or backwards
No ios::nocreate/ios::noreplace. +
No basic_stringbuf, basic_stringstream
Little or no wide character support
No templatized iostreams
Thread safety issues
Third
Pre-ISO headers removed
Extension headers hash_map, hash_set moved to ext or backwards
No ios::nocreate/ios::noreplace.
No stream::attach(int fd)
diff --git a/libstdc++-v3/doc/html/manual/appendix_contributing.html b/libstdc++-v3/doc/html/manual/appendix_contributing.html index 858b03a..4bbae64 100644 --- a/libstdc++-v3/doc/html/manual/appendix_contributing.html +++ b/libstdc++-v3/doc/html/manual/appendix_contributing.html @@ -25,9 +25,9 @@ the standard from their respective national standards organization. In the USA, this national standards organization is - ANSI. - (And if you've already registered with them you can - buy the standard on-line.) + ANSI. + (And if you've already registered with them you can buy + the standard on-line.)

  • The library working group bugs, and known defects, can be obtained here: diff --git a/libstdc++-v3/doc/html/manual/appendix_porting.html b/libstdc++-v3/doc/html/manual/appendix_porting.html index 165c37d..16b154f 100644 --- a/libstdc++-v3/doc/html/manual/appendix_porting.html +++ b/libstdc++-v3/doc/html/manual/appendix_porting.html @@ -18,7 +18,7 @@ C++11 Requirements Test Sequence Descriptions

    • No vector::at, deque::at, string::at
    No std::char_traits<char>::eof
    No string::clear
    Removal of ostream::form and istream::scan extensions -
    No basic_stringbuf, basic_stringstream
    Little or no wide character support
    No templatized iostreams
    Thread safety issues
    Third
    Pre-ISO headers moved to backwards or removed
    Extension headers hash_map, hash_set moved to ext or backwards
    No ios::nocreate/ios::noreplace. +
    No basic_stringbuf, basic_stringstream
    Little or no wide character support
    No templatized iostreams
    Thread safety issues
    Third
    Pre-ISO headers removed
    Extension headers hash_map, hash_set moved to ext or backwards
    No ios::nocreate/ios::noreplace.
    No stream::attach(int fd)
    diff --git a/libstdc++-v3/doc/html/manual/backwards.html b/libstdc++-v3/doc/html/manual/backwards.html index bc21420..e69451e 100644 --- a/libstdc++-v3/doc/html/manual/backwards.html +++ b/libstdc++-v3/doc/html/manual/backwards.html @@ -364,75 +364,15 @@ libstdc++-v3. of the SGI STL (version 3.3), with extensive changes.

    A more formal description of the V3 goals can be found in the official design document. -

    Portability notes and known implementation limitations are as follows.

    Pre-ISO headers moved to backwards or removed

    The pre-ISO C++ headers +

    Portability notes and known implementation limitations are as follows.

    Pre-ISO headers removed

    The pre-ISO C++ headers (<iostream.h>, <defalloc.h> etc.) are - available, unlike previous libstdc++ versions, but inclusion - generates a warning that you are using deprecated headers. -

    This compatibility layer is constructed by including the - standard C++ headers, and injecting any items in - std:: into the global namespace. -

    For those of you new to ISO C++ (welcome, time travelers!), no, - that isn't a typo. Yes, the headers really have new names. - Marshall Cline's C++ FAQ Lite has a good explanation in What's + not supported. +

    For those of you new to ISO C++ (welcome, time travelers!), the + ancient pre-ISO headers have new names. + The C++ FAQ has a good explanation in What's the difference between <xxx> and <xxx.h> headers?. -

    Some include adjustment may be required. What follows is an -autoconf test that defines PRE_STDCXX_HEADERS when they -exist.

    -# AC_HEADER_PRE_STDCXX
-AC_DEFUN([AC_HEADER_PRE_STDCXX], [
-  AC_CACHE_CHECK(for pre-ISO C++ include files,
-  ac_cv_cxx_pre_stdcxx,
-  [AC_LANG_SAVE
-  AC_LANG_CPLUSPLUS
-  ac_save_CXXFLAGS="$CXXFLAGS"
-  CXXFLAGS="$CXXFLAGS -Wno-deprecated"
-
-  # Omit defalloc.h, as compilation with newer compilers is problematic.
-  AC_TRY_COMPILE([
-  #include <new.h>
-  #include <iterator.h>
-  #include <alloc.h>
-  #include <set.h>
-  #include <hashtable.h>
-  #include <hash_set.h>
-  #include <fstream.h>
-  #include <tempbuf.h>
-  #include <istream.h>
-  #include <bvector.h>
-  #include <stack.h>
-  #include <rope.h>
-  #include <complex.h>
-  #include <ostream.h>
-  #include <heap.h>
-  #include <iostream.h>
-  #include <function.h>
-  #include <multimap.h>
-  #include <pair.h>
-  #include <stream.h>
-  #include <iomanip.h>
-  #include <slist.h>
-  #include <tree.h>
-  #include <vector.h>
-  #include <deque.h>
-  #include <multiset.h>
-  #include <list.h>
-  #include <map.h>
-  #include <algobase.h>
-  #include <hash_map.h>
-  #include <algo.h>
-  #include <queue.h>
-  #include <streambuf.h>
-  ],,
-  ac_cv_cxx_pre_stdcxx=yes, ac_cv_cxx_pre_stdcxx=no)
-  CXXFLAGS="$ac_save_CXXFLAGS"
-  AC_LANG_RESTORE
-  ])
-  if test "$ac_cv_cxx_pre_stdcxx" = yes; then
-    AC_DEFINE(PRE_STDCXX_HEADERS,,[Define if pre-ISO C++ header files are present. ])
-  fi
-])
-

    Porting between pre-ISO headers and ISO headers is simple: headers +

    Porting between pre-ISO headers and ISO headers is simple: headers like <vector.h> can be replaced with <vector> and a using directive using namespace std; can be put at the global scope. This should be enough to get this code compiling, assuming the diff --git a/libstdc++-v3/doc/html/manual/index.html b/libstdc++-v3/doc/html/manual/index.html index e6a54b5..2d6fbba 100644 --- a/libstdc++-v3/doc/html/manual/index.html +++ b/libstdc++-v3/doc/html/manual/index.html @@ -127,7 +127,7 @@ C++11 Requirements Test Sequence Descriptions

    No vector::at, deque::at, string::at
    No std::char_traits<char>::eof
    No string::clear
    Removal of ostream::form and istream::scan extensions -
    No basic_stringbuf, basic_stringstream
    Little or no wide character support
    No templatized iostreams
    Thread safety issues
    Third
    Pre-ISO headers moved to backwards or removed
    Extension headers hash_map, hash_set moved to ext or backwards
    No ios::nocreate/ios::noreplace. +
    No basic_stringbuf, basic_stringstream
    Little or no wide character support
    No templatized iostreams
    Thread safety issues
    Third
    Pre-ISO headers removed
    Extension headers hash_map, hash_set moved to ext or backwards
    No ios::nocreate/ios::noreplace.
    No stream::attach(int fd)
    diff --git a/libstdc++-v3/doc/html/manual/status.html b/libstdc++-v3/doc/html/manual/status.html index 0507cc7..7b6c584 100644 --- a/libstdc++-v3/doc/html/manual/status.html +++ b/libstdc++-v3/doc/html/manual/status.html @@ -676,11 +676,7 @@ Feature-testing recommendations for C++. P0258R2 - 7 __cpp_lib_has_unique_object_representations >= 201606 Ordered by default - - P0181R1 - - No __cpp_lib_default_order >= 201606 Polishing <chrono> + 7 __cpp_lib_has_unique_object_representations >= 201606 Polishing <chrono> P0092R1 @@ -780,7 +776,11 @@ Feature-testing recommendations for C++. P0156R2 - 7 __cpp_lib_scoped_lock >= 201703

    Table 1.6. C++ Technical Specifications Implementation Status

    PaperTitleStatusComments
    + 7 __cpp_lib_scoped_lock >= 201703
    + + P0298R3 + + 7 ???

    Table 1.6. C++ Technical Specifications Implementation Status

    PaperTitleStatusComments
    N4076 diff --git a/libstdc++-v3/doc/html/manual/streambufs.html b/libstdc++-v3/doc/html/manual/streambufs.html index c6f311e..0dddd92 100644 --- a/libstdc++-v3/doc/html/manual/streambufs.html +++ b/libstdc++-v3/doc/html/manual/streambufs.html @@ -53,9 +53,10 @@ return 0; }

    Try it yourself! More examples can be found in 3.1.x code, in - include/ext/*_filebuf.h, and in this article by James Kanze: - Filtering - Streambufs. + include/ext/*_filebuf.h, and in the article + Filtering + Streambufs + by James Kanze.

    Buffering

    First, are you sure that you understand buffering? Particularly the fact that C++ may not, in fact, have anything to do with it?

    The rules for buffering can be a little odd, but they aren't any diff --git a/libstdc++-v3/doc/html/manual/using_concurrency.html b/libstdc++-v3/doc/html/manual/using_concurrency.html index c30cd66..b404027 100644 --- a/libstdc++-v3/doc/html/manual/using_concurrency.html +++ b/libstdc++-v3/doc/html/manual/using_concurrency.html @@ -158,7 +158,7 @@ gcc version 4.1.2 20070925 (Red Hat 4.1.2-33) }

    For further details of the C++11 memory model see Hans-J. Boehm's Threads - and memory model for C++ pages, particularly the introduction + and memory model for C++ pages, particularly the introduction and FAQ.

    Atomics

    IO

    This gets a bit tricky. Please read carefully, and bear with me. diff --git a/libstdc++-v3/doc/xml/faq.xml b/libstdc++-v3/doc/xml/faq.xml index db67626..340ba9d 100644 --- a/libstdc++-v3/doc/xml/faq.xml +++ b/libstdc++-v3/doc/xml/faq.xml @@ -1177,7 +1177,8 @@ - Please refer to the Contributing section in our manual. + Please refer to the Contributing + section in our manual. diff --git a/libstdc++-v3/doc/xml/manual/backwards_compatibility.xml b/libstdc++-v3/doc/xml/manual/backwards_compatibility.xml index 579c368..dbb3371 100644 --- a/libstdc++-v3/doc/xml/manual/backwards_compatibility.xml +++ b/libstdc++-v3/doc/xml/manual/backwards_compatibility.xml @@ -598,86 +598,21 @@ libstdc++-v3. Portability notes and known implementation limitations are as follows. -

    Pre-ISO headers moved to backwards or removed +
    Pre-ISO headers removed The pre-ISO C++ headers (<iostream.h>, <defalloc.h> etc.) are - available, unlike previous libstdc++ versions, but inclusion - generates a warning that you are using deprecated headers. + not supported. - This compatibility layer is constructed by including the - standard C++ headers, and injecting any items in - std:: into the global namespace. - - For those of you new to ISO C++ (welcome, time travelers!), no, - that isn't a typo. Yes, the headers really have new names. - Marshall Cline's C++ FAQ Lite has a good explanation in What's + For those of you new to ISO C++ (welcome, time travelers!), the + ancient pre-ISO headers have new names. + The C++ FAQ has a good explanation in What's the difference between <xxx> and <xxx.h> headers?. - Some include adjustment may be required. What follows is an -autoconf test that defines PRE_STDCXX_HEADERS when they -exist. - - -# AC_HEADER_PRE_STDCXX -AC_DEFUN([AC_HEADER_PRE_STDCXX], [ - AC_CACHE_CHECK(for pre-ISO C++ include files, - ac_cv_cxx_pre_stdcxx, - [AC_LANG_SAVE - AC_LANG_CPLUSPLUS - ac_save_CXXFLAGS="$CXXFLAGS" - CXXFLAGS="$CXXFLAGS -Wno-deprecated" - - # Omit defalloc.h, as compilation with newer compilers is problematic. - AC_TRY_COMPILE([ - #include <new.h> - #include <iterator.h> - #include <alloc.h> - #include <set.h> - #include <hashtable.h> - #include <hash_set.h> - #include <fstream.h> - #include <tempbuf.h> - #include <istream.h> - #include <bvector.h> - #include <stack.h> - #include <rope.h> - #include <complex.h> - #include <ostream.h> - #include <heap.h> - #include <iostream.h> - #include <function.h> - #include <multimap.h> - #include <pair.h> - #include <stream.h> - #include <iomanip.h> - #include <slist.h> - #include <tree.h> - #include <vector.h> - #include <deque.h> - #include <multiset.h> - #include <list.h> - #include <map.h> - #include <algobase.h> - #include <hash_map.h> - #include <algo.h> - #include <queue.h> - #include <streambuf.h> - ],, - ac_cv_cxx_pre_stdcxx=yes, ac_cv_cxx_pre_stdcxx=no) - CXXFLAGS="$ac_save_CXXFLAGS" - AC_LANG_RESTORE - ]) - if test "$ac_cv_cxx_pre_stdcxx" = yes; then - AC_DEFINE(PRE_STDCXX_HEADERS,,[Define if pre-ISO C++ header files are present. ]) - fi -]) - - Porting between pre-ISO headers and ISO headers is simple: headers like <vector.h> can be replaced with <vector> and a using directive using namespace std; can be put at the global diff --git a/libstdc++-v3/doc/xml/manual/io.xml b/libstdc++-v3/doc/xml/manual/io.xml index 36d04ff..0c069b3 100644 --- a/libstdc++-v3/doc/xml/manual/io.xml +++ b/libstdc++-v3/doc/xml/manual/io.xml @@ -240,9 +240,10 @@ } Try it yourself! More examples can be found in 3.1.x code, in - include/ext/*_filebuf.h, and in this article by James Kanze: - Filtering - Streambufs. + include/ext/*_filebuf.h, and in the article + Filtering + Streambufs + by James Kanze.
    diff --git a/libstdc++-v3/doc/xml/manual/using.xml b/libstdc++-v3/doc/xml/manual/using.xml index 1970845..3057a93 100644 --- a/libstdc++-v3/doc/xml/manual/using.xml +++ b/libstdc++-v3/doc/xml/manual/using.xml @@ -1625,7 +1625,7 @@ gcc version 4.1.2 20070925 (Red Hat 4.1.2-33) For further details of the C++11 memory model see Hans-J. Boehm's Threads - and memory model for C++ pages, particularly the introduction + and memory model for C++ pages, particularly the introduction and FAQ. -- 2.7.4