From 3670dbe49059ab1746ac2e3b77940160c05db6c2 Mon Sep 17 00:00:00 2001 From: Jonathan Wakely Date: Wed, 27 Jan 2021 17:52:27 +0000 Subject: [PATCH] libstdc++: Regenerate libstdc++ HTML docs libstdc++-v3/ChangeLog: * doc/xml/manual/status_cxx2017.xml: Replace invalid entity. * doc/html/*: Regenerate. --- libstdc++-v3/doc/html/index.html | 6 +- libstdc++-v3/doc/html/manual/index.html | 4 +- libstdc++-v3/doc/html/manual/intro.html | 2 +- libstdc++-v3/doc/html/manual/status.html | 124 +++++++++++++++++- .../doc/xml/manual/status_cxx2017.xml | 2 +- 5 files changed, 124 insertions(+), 14 deletions(-) diff --git a/libstdc++-v3/doc/html/index.html b/libstdc++-v3/doc/html/index.html index d336859f1df..587d4ee819a 100644 --- a/libstdc++-v3/doc/html/index.html +++ b/libstdc++-v3/doc/html/index.html @@ -1,6 +1,6 @@ -The GNU C++ Library

The GNU C++ Library

Short Contents

- Copyright (C) 2008-2020 +The GNU C++ Library

The GNU C++ Library

Short Contents

+ Copyright (C) 2008-2021 FSF

@@ -23,7 +23,7 @@


Table of Contents

The GNU C++ Library Manual
I. Introduction -
1. Status
Implementation Status
C++ 1998/2003
Implementation Status
Implementation Specific Behavior
C++ 2011
Implementation Specific Behavior
C++ 2014
C++ 2017
Implementation Specific Behavior
C++ 2020
C++ TR1
Implementation Specific Behavior
C++ TR 24733
C++ IS 29124
Implementation Specific Behavior
License
The Code: GPL
The Documentation: GPL, FDL
Bugs
Implementation Bugs
Standard Bugs
2. Setup
Prerequisites
Configure
Make
3. Using
Command Options
Headers
Header Files
Mixing Headers
The C Headers and namespace std
Precompiled Headers
Macros
Dual ABI
Troubleshooting
Namespaces
Available Namespaces
namespace std
Using Namespace Composition
Linking
Almost Nothing
Finding Dynamic or Shared Libraries
Experimental Library Extensions
Concurrency
Prerequisites
Thread Safety
Atomics
IO
Structure
Defaults
Future
Alternatives
Containers
Exceptions
Exception Safety
Exception Neutrality
Doing without
Compatibility
With C
With POSIX thread cancellation
Debugging Support
Using g++
Debug Versions of Library Binary Files
Memory Leak Hunting
Non-memory leaks in Pool and MT allocators
Data Race Hunting
Using gdb
Tracking uncaught exceptions
Debug Mode
Compile Time Checking
II. +
1. Status
Implementation Status
C++ 1998/2003
Implementation Status
Implementation Specific Behavior
C++ 2011
Implementation Specific Behavior
C++ 2014
C++ 2017
Implementation Specific Behavior
Parallelism 2 TS
C++ 2020
C++ TR1
Implementation Specific Behavior
C++ TR 24733
C++ IS 29124
Implementation Specific Behavior
License
The Code: GPL
The Documentation: GPL, FDL
Bugs
Implementation Bugs
Standard Bugs
2. Setup
Prerequisites
Configure
Make
3. Using
Command Options
Headers
Header Files
Mixing Headers
The C Headers and namespace std
Precompiled Headers
Macros
Dual ABI
Troubleshooting
Namespaces
Available Namespaces
namespace std
Using Namespace Composition
Linking
Almost Nothing
Finding Dynamic or Shared Libraries
Experimental Library Extensions
Concurrency
Prerequisites
Thread Safety
Atomics
IO
Structure
Defaults
Future
Alternatives
Containers
Exceptions
Exception Safety
Exception Neutrality
Doing without
Compatibility
With C
With POSIX thread cancellation
Debugging Support
Using g++
Debug Versions of Library Binary Files
Memory Leak Hunting
Non-memory leaks in Pool and MT allocators
Data Race Hunting
Using gdb
Tracking uncaught exceptions
Debug Mode
Compile Time Checking
II. Standard Contents
4. Support diff --git a/libstdc++-v3/doc/html/manual/index.html b/libstdc++-v3/doc/html/manual/index.html index ef7eaee45f5..d66de295f11 100644 --- a/libstdc++-v3/doc/html/manual/index.html +++ b/libstdc++-v3/doc/html/manual/index.html @@ -4,7 +4,7 @@


Table of Contents

I. Introduction -
1. Status
Implementation Status
C++ 1998/2003
Implementation Status
Implementation Specific Behavior
C++ 2011
Implementation Specific Behavior
C++ 2014
C++ 2017
Implementation Specific Behavior
C++ 2020
C++ TR1
Implementation Specific Behavior
C++ TR 24733
C++ IS 29124
Implementation Specific Behavior
License
The Code: GPL
The Documentation: GPL, FDL
Bugs
Implementation Bugs
Standard Bugs
2. Setup
Prerequisites
Configure
Make
3. Using
Command Options
Headers
Header Files
Mixing Headers
The C Headers and namespace std
Precompiled Headers
Macros
Dual ABI
Troubleshooting
Namespaces
Available Namespaces
namespace std
Using Namespace Composition
Linking
Almost Nothing
Finding Dynamic or Shared Libraries
Experimental Library Extensions
Concurrency
Prerequisites
Thread Safety
Atomics
IO
Structure
Defaults
Future
Alternatives
Containers
Exceptions
Exception Safety
Exception Neutrality
Doing without
Compatibility
With C
With POSIX thread cancellation
Debugging Support
Using g++
Debug Versions of Library Binary Files
Memory Leak Hunting
Non-memory leaks in Pool and MT allocators
Data Race Hunting
Using gdb
Tracking uncaught exceptions
Debug Mode
Compile Time Checking
II. +
1. Status
Implementation Status
C++ 1998/2003
Implementation Status
Implementation Specific Behavior
C++ 2011
Implementation Specific Behavior
C++ 2014
C++ 2017
Implementation Specific Behavior
Parallelism 2 TS
C++ 2020
C++ TR1
Implementation Specific Behavior
C++ TR 24733
C++ IS 29124
Implementation Specific Behavior
License
The Code: GPL
The Documentation: GPL, FDL
Bugs
Implementation Bugs
Standard Bugs
2. Setup
Prerequisites
Configure
Make
3. Using
Command Options
Headers
Header Files
Mixing Headers
The C Headers and namespace std
Precompiled Headers
Macros
Dual ABI
Troubleshooting
Namespaces
Available Namespaces
namespace std
Using Namespace Composition
Linking
Almost Nothing
Finding Dynamic or Shared Libraries
Experimental Library Extensions
Concurrency
Prerequisites
Thread Safety
Atomics
IO
Structure
Defaults
Future
Alternatives
Containers
Exceptions
Exception Safety
Exception Neutrality
Doing without
Compatibility
With C
With POSIX thread cancellation
Debugging Support
Using g++
Debug Versions of Library Binary Files
Memory Leak Hunting
Non-memory leaks in Pool and MT allocators
Data Race Hunting
Using gdb
Tracking uncaught exceptions
Debug Mode
Compile Time Checking
II. Standard Contents
4. Support @@ -149,7 +149,7 @@ Support for C++11 dialect.
21.10. Non-unique Mapping Containers
21.11. Point Iterator Hierarchy
21.12. Invalidation Guarantee Tags Hierarchy
21.13. Container Tag Hierarchy
21.14. Hash functions, ranged-hash functions, and range-hashing functions
21.15. Insert hash sequence diagram
21.16. Insert hash sequence diagram with a null policy
21.17. Hash policy class diagram
21.18. Balls and bins
21.19. Insert resize sequence diagram
21.20. Standard resize policy trigger sequence diagram
21.21. Standard resize policy size sequence - diagram
21.22. Tree node invariants
21.23. Tree node invalidation
21.24. A tree and its update policy
21.25. Restoring node invariants
21.26. Insert update sequence
21.27. Useless update path
21.28. A PATRICIA trie
21.29. A trie and its update policy
21.30. A simple list
21.31. The counter algorithm
21.32. Underlying Priority-Queue Data-Structures.
21.33. Priority-Queue Data-Structure Tags.
B.1. Configure and Build File Dependencies
\ No newline at end of file +
\ No newline at end of file diff --git a/libstdc++-v3/doc/html/manual/status.html b/libstdc++-v3/doc/html/manual/status.html index c5b8185c43f..334e093c00c 100644 --- a/libstdc++-v3/doc/html/manual/status.html +++ b/libstdc++-v3/doc/html/manual/status.html @@ -2,7 +2,7 @@ Chapter 1. Status

Chapter 1. Status

Implementation Status

C++ 1998/2003

Implementation Status

+ Next


Chapter 1. Status

Implementation Status

C++ 1998/2003

Implementation Status

This status table is based on the table of contents of ISO/IEC 14882:2003.

This section describes the C++ support in mainline GCC, not in any @@ -983,7 +983,11 @@ since C++14 and the implementation is complete. N4531 - std::rand replacement, revision 3YLibrary Fundamentals 2 TS


Implementation Specific Behavior

For behaviour which is also specified by previous standards, + std::rand replacement, revision 3YLibrary Fundamentals 2 TS + + P0214R9 + + Data-Parallel TypesYParallelism 2 TS


Implementation Specific Behavior

For behaviour which is also specified by previous standards, see C++ 1998/2003 Implementation Specific Behavior and C++ 2011 Implementation Specific Behavior. This section only @@ -1083,7 +1087,113 @@ since C++14 and the implementation is complete.

30.10.15.4 [fs.op.file_size] If !is_regular_file(p), an error is reported. -

C++ 2020

+

Parallelism 2 TS

+ 9.3 [parallel.simd.abi] + max_fixed_size<T> is 32, except when targetting + AVX512BW and sizeof(T) is 1. +

+ When targeting 32-bit x86, + simd_abi::compatible<T> is an alias for + simd_abi::scalar. + When targeting 64-bit x86 (including x32) or Aarch64, + simd_abi::compatible<T> is an alias for + simd_abi::_VecBuiltin<16>, + unless T is long double, in which case it is + an alias for simd_abi::scalar. + When targeting ARM (but not Aarch64) with NEON support, + simd_abi::compatible<T> is an alias for + simd_abi::_VecBuiltin<16>, + unless sizeof(T) > 4, in which case it is + an alias for simd_abi::scalar. Additionally, + simd_abi::compatible<float> is an alias for + simd_abi::scalar unless compiling with + -ffast-math. +

+ When targeting x86 (both 32-bit and 64-bit), + simd_abi::native<T> is an alias for one of + simd_abi::scalar, + simd_abi::_VecBuiltin<16>, + simd_abi::_VecBuiltin<32>, or + simd_abi::_VecBltnBtmsk<64>, depending on + T and the machine options the compiler was invoked with. +

+ When targeting ARM/Aarch64 or POWER, + simd_abi::native<T> is an alias for + simd_abi::scalar or + simd_abi::_VecBuiltin<16>, depending on + T and the machine options the compiler was invoked with. +

+ For any other targeted machine + simd_abi::compatible<T> and + simd_abi::native<T> are aliases for + simd_abi::scalar. (subject to change) +

+ The extended ABI tag types defined in the + std::experimental::parallelism_v2::simd_abi namespace are: + simd_abi::_VecBuiltin<Bytes>, and + simd_abi::_VecBltnBtmsk<Bytes>. +

+ simd_abi::deduce<T, N, Abis...>::type, + with N > 1 is an alias for an extended ABI tag, if a + supported extended ABI tag exists. Otherwise it is an alias for + simd_abi::fixed_size<N>. The + simd_abi::_VecBltnBtmsk ABI tag is preferred over + simd_abi::_VecBuiltin. +

+ 9.4 [parallel.simd.traits] + memory_alignment<T, U>::value is + sizeof(U) * T::size() rounded up to the next power-of-two + value. +

+ 9.6.1 [parallel.simd.overview] + On ARM, simd<T, _VecBuiltin<Bytes>> + is supported if __ARM_NEON is defined and + sizeof(T) <= 4. Additionally, + sizeof(T) == 8 with integral T is supported if + __ARM_ARCH >= 8, and double is supported if + __aarch64__ is defined. + + On POWER, simd<T, _VecBuiltin<Bytes>> + is supported if __ALTIVEC__ is defined and sizeof(T) + < 8. Additionally, double is supported if + __VSX__ is defined, and any T with + sizeof(T) <= 8 is supported if __POWER8_VECTOR__ + is defined. + + On x86, given an extended ABI tag Abi, + simd<T, Abi> is supported according to the + following table: +

Table 1.8. Support for Extended ABI Tags

ABI tag Abivalue type Tvalues for Bytesrequired machine option
+ _VecBuiltin<Bytes> + float8, 12, 16"-msse"
20, 24, 28, 32"-mavx"
double16"-msse2"
24, 32"-mavx"
+ integral types other than bool + + Bytes ≤ 16 and Bytes divisible by + sizeof(T) + "-msse2"
+ 16 < Bytes ≤ 32 and Bytes + divisible by sizeof(T) + "-mavx2"
+ _VecBuiltin<Bytes> and + _VecBltnBtmsk<Bytes> + + vectorizable types with sizeof(T) ≥ 4 + + 32 < Bytes ≤ 64 and Bytes + divisible by sizeof(T) + "-mavx512f"
+ vectorizable types with sizeof(T) < 4 + "-mavx512bw"
+ _VecBltnBtmsk<Bytes> + + vectorizable types with sizeof(T) ≥ 4 + + Bytes ≤ 32 and Bytes divisible by + sizeof(T) + "-mavx512vl"
+ vectorizable types with sizeof(T) < 4 + "-mavx512bw" and "-mavx512vl"


+

C++ 2020

In this implementation the -std=gnu++2a or -std=c++2a flag must be used to enable language and library @@ -1106,7 +1216,7 @@ The "SD-6 Feature Test / Notes" column shows the corresponding macro or header f SD-6: Feature-testing recommendations for C++ (where applicable) or any notes about the implementation. -

Table 1.8. C++ 2020 Library Features

Library FeatureProposalStatusSD-6 Feature Test / Notes
+

Table 1.9. C++ 2020 Library Features

Library FeatureProposalStatusSD-6 Feature Test / Notes
Compile-time programming
Add constexpr modifiers to functions in <algorithm> and <utility> Headers @@ -1551,7 +1661,7 @@ In this implementation the header names are prefixed by

This page describes the TR1 support in mainline GCC, not in any particular release. -

Table 1.9. C++ TR1 Implementation Status

SectionDescriptionStatusComments
2General Utilities
2.1Reference wrappers  
2.1.1Additions to header <functional> synopsisY 
2.1.2Class template reference_wrapper  
2.1.2.1reference_wrapper construct/copy/destroyY 
2.1.2.2reference_wrapper assignmentY 
2.1.2.3reference_wrapper accessY 
2.1.2.4reference_wrapper invocationY 
2.1.2.5reference_wrapper helper functionsY 
2.2Smart pointers  
2.2.1Additions to header <memory> synopsisY 
2.2.2Class bad_weak_ptrY 
2.2.3Class template shared_ptr  +

Table 1.10. C++ TR1 Implementation Status

SectionDescriptionStatusComments
2General Utilities
2.1Reference wrappers  
2.1.1Additions to header <functional> synopsisY 
2.1.2Class template reference_wrapper  
2.1.2.1reference_wrapper construct/copy/destroyY 
2.1.2.2reference_wrapper assignmentY 
2.1.2.3reference_wrapper accessY 
2.1.2.4reference_wrapper invocationY 
2.1.2.5reference_wrapper helper functionsY 
2.2Smart pointers  
2.2.1Additions to header <memory> synopsisY 
2.2.2Class bad_weak_ptrY 
2.2.3Class template shared_ptr 

Uses code from boost::shared_ptr. @@ -1572,7 +1682,7 @@ decimal floating-point arithmetic

This page describes the TR 24733 support in mainline GCC, not in any particular release. -

Table 1.10. C++ TR 24733 Implementation Status

SectionDescriptionStatusComments
+

Table 1.11. C++ TR 24733 Implementation Status

SectionDescriptionStatusComments
0 Introduction @@ -1612,7 +1722,7 @@ non-strict modes (i.e. -std=gnu++NN modes) the hypergeometric functions and confluent hypergeometric functions from TR1 are also provided, defined in namespace __gnu_cxx. -

Table 1.11. C++ Special Functions Implementation Status

SectionDescriptionStatusComments
7Macro namesPartialNo diagnostic for inconsistent definitions of +

Table 1.12. C++ Special Functions Implementation Status

SectionDescriptionStatusComments
7Macro namesPartialNo diagnostic for inconsistent definitions of __STDCPP_WANT_MATH_SPEC_FUNCS__
8Mathematical special functionsY 
8.1Additions to header <cmath> synopsisY 
8.1.1associated Laguerre polynomialsY 
8.1.2associated Legendre functionsY 
8.1.3beta functionY 
8.1.4(complete) elliptic integral of the first kindY 
8.1.5(complete) elliptic integral of the second kindY 
8.1.6(complete) elliptic integral of the third kindY 
8.1.7regular modified cylindrical Bessel functionsY 
8.1.8cylindrical Bessel functions (of the first kind)Y 
8.1.9irregular modified cylindrical Bessel functionsY 
8.1.10cylindrical Neumann functionsY 
8.1.11(incomplete) elliptic integral of the first kindY 
8.1.12(incomplete) elliptic integral of the second kindY 
8.1.13(incomplete) elliptic integral of the third kindY 
8.1.14exponential integralY 
8.1.15Hermite polynomialsY 
8.1.16Laguerre polynomialsY 
8.1.17Legendre polynomialsY 
8.1.18Riemann zeta functionY 
8.1.19spherical Bessel functions (of the first kind)Y 
8.1.20spherical associated Legendre functionsY 
8.1.21spherical Neumann functionsY 
8.2Additions to header <math.h>Y 
8.3The header <ctgmath>PartialConflicts with C++ 2011 requirements.
8.4The header <tgmath.h>NConflicts with C++ 2011 requirements.

Implementation Specific Behavior

For behaviour which is specified by the 2011 standard, see C++ 2011 Implementation Specific Behavior. This section documents behaviour which diff --git a/libstdc++-v3/doc/xml/manual/status_cxx2017.xml b/libstdc++-v3/doc/xml/manual/status_cxx2017.xml index bc740f8e1ba..f97fc060fa0 100644 --- a/libstdc++-v3/doc/xml/manual/status_cxx2017.xml +++ b/libstdc++-v3/doc/xml/manual/status_cxx2017.xml @@ -3113,7 +3113,7 @@ since C++14 and the implementation is complete. is supported if __ALTIVEC__ is defined and sizeof(T) < 8. Additionally, double is supported if __VSX__ is defined, and any T with - sizeof(T) ≤ 8 is supported if __POWER8_VECTOR__ + sizeof(T) <= 8 is supported if __POWER8_VECTOR__ is defined. On x86, given an extended ABI tag Abi, -- 2.30.2