From 37ad0fc9425515ab827275428a107911f512b29f Mon Sep 17 00:00:00 2001 From: Jonathan Wakely Date: Thu, 30 May 2019 11:14:06 +0100 Subject: [PATCH] Update documentation of implementation-defined library features * doc/xml/manual/status_cxx2011.xml: Use for documentation of implementation-defined types for [thread.req.native]. * doc/xml/manual/status_cxx2017.xml: Update documentation of implementation-defined strings for [variant.bad.access]. Fix typo in documentation of implementation-defined support for [fs.conform.9945]. * doc/html/*: Regenerate. From-SVN: r271773 --- libstdc++-v3/ChangeLog | 9 ++++ libstdc++-v3/doc/html/manual/status.html | 29 ++++++------ .../doc/xml/manual/status_cxx2011.xml | 45 ++++++++++++------- .../doc/xml/manual/status_cxx2017.xml | 8 +++- 4 files changed, 60 insertions(+), 31 deletions(-) diff --git a/libstdc++-v3/ChangeLog b/libstdc++-v3/ChangeLog index 4543aea7f37..0618f8d84ae 100644 --- a/libstdc++-v3/ChangeLog +++ b/libstdc++-v3/ChangeLog @@ -1,3 +1,12 @@ +2019-05-30 Jonathan Wakely + + * doc/xml/manual/status_cxx2011.xml: Use for + documentation of implementation-defined types for [thread.req.native]. + * doc/xml/manual/status_cxx2017.xml: Update documentation of + implementation-defined strings for [variant.bad.access]. Fix typo in + documentation of implementation-defined support for [fs.conform.9945]. + * doc/html/*: Regenerate. + 2019-05-29 Jonathan Wakely PR libstdc++/85494 diff --git a/libstdc++-v3/doc/html/manual/status.html b/libstdc++-v3/doc/html/manual/status.html index 398a9490a18..51b9860c844 100644 --- a/libstdc++-v3/doc/html/manual/status.html +++ b/libstdc++-v3/doc/html/manual/status.html @@ -374,26 +374,25 @@ particular release. is subject to change at any time. Any use of native_handle is inherently non-portable and not guaranteed to work between major releases of GCC. -

  • thread: The native handle type is - a typedef for __gthread_t i.e. pthread_t - when GCC is configured with the posix thread - model. The value of the native handle is undefined for a thread +

    thread
    + The native handle type is a typedef for __gthread_t + i.e. pthread_t when GCC is configured with the + posix thread model. + The value of the native handle is undefined for a thread which is not joinable. -

  • mutex and - timed_mutex: +

    mutex, timed_mutex
    The native handle type is __gthread_mutex_t* i.e. pthread_mutex_t* for the posix thread model. -

  • recursive_mutex and - recursive_timed_mutex: +

    recursive_mutex, recursive_timed_mutex
    The native handle type is __gthread_recursive_mutex_t* i.e. pthread_mutex_t* for the posix thread model. -

  • condition_variable: The native - handle type is __gthread_cond_t* i.e. +

    condition_variable
    + The native handle type is __gthread_cond_t* i.e. pthread_cond_t* for the posix thread model. -

+

30.6.1 [futures.overview]/2 launch is a scoped enumeration type with @@ -945,7 +944,11 @@ and test for __STDCPP_MATH_SPEC_FUNCS__ >= 201003L. variant supports over-aligned types.

23.7.10 [variant.bad.access] - what() returns "Unexpected index". + what() returns one of the strings + "std::get: variant is valueless", + "std::get: wrong index for variant", + "std::visit: variant is valueless", + or "std::visit<R>: variant is valueless".

23.12.5.2 [memory.resource.pool.options] Let S equal numeric_limits<size_t>::digits. @@ -998,7 +1001,7 @@ and test for __STDCPP_MATH_SPEC_FUNCS__ >= 201003L.

30.10.2.1 [fs.conform.9945] The behavior of the filesystem library implementation will depend on - the target operating system. Some features will not be not supported + the target operating system. Some features will not be supported on some targets.

30.10.5 [fs.filesystem.syn] diff --git a/libstdc++-v3/doc/xml/manual/status_cxx2011.xml b/libstdc++-v3/doc/xml/manual/status_cxx2011.xml index 9c25b8fd81f..6f3551ff65d 100644 --- a/libstdc++-v3/doc/xml/manual/status_cxx2011.xml +++ b/libstdc++-v3/doc/xml/manual/status_cxx2011.xml @@ -2793,31 +2793,44 @@ particular release. is subject to change at any time. Any use of native_handle is inherently non-portable and not guaranteed to work between major releases of GCC. - - thread: The native handle type is - a typedef for __gthread_t i.e. pthread_t - when GCC is configured with the posix thread - model. The value of the native handle is undefined for a thread + + + thread + + The native handle type is a typedef for __gthread_t + i.e. pthread_t when GCC is configured with the + posix thread model. + The value of the native handle is undefined for a thread which is not joinable. - - mutex and - timed_mutex: + + + + mutex + timed_mutex + The native handle type is __gthread_mutex_t* i.e. pthread_mutex_t* for the posix thread model. - - recursive_mutex and - recursive_timed_mutex: + + + + recursive_mutex + recursive_timed_mutex + The native handle type is __gthread_recursive_mutex_t* i.e. pthread_mutex_t* for the posix thread model. - - condition_variable: The native - handle type is __gthread_cond_t* i.e. + + + + condition_variable + + The native handle type is __gthread_cond_t* i.e. pthread_cond_t* for the posix thread model. - - + + + diff --git a/libstdc++-v3/doc/xml/manual/status_cxx2017.xml b/libstdc++-v3/doc/xml/manual/status_cxx2017.xml index a11e93cda90..9aba079c251 100644 --- a/libstdc++-v3/doc/xml/manual/status_cxx2017.xml +++ b/libstdc++-v3/doc/xml/manual/status_cxx2017.xml @@ -1043,7 +1043,11 @@ and test for __STDCPP_MATH_SPEC_FUNCS__ >= 201003L. 23.7.10 [variant.bad.access] - what() returns "Unexpected index". + what() returns one of the strings + "std::get: variant is valueless", + "std::get: wrong index for variant", + "std::visit: variant is valueless", + or "std::visit<R>: variant is valueless". @@ -1117,7 +1121,7 @@ and test for __STDCPP_MATH_SPEC_FUNCS__ >= 201003L. 30.10.2.1 [fs.conform.9945] The behavior of the filesystem library implementation will depend on - the target operating system. Some features will not be not supported + the target operating system. Some features will not be supported on some targets. -- 2.30.2