From: redi Date: Thu, 2 May 2019 15:44:55 +0000 (+0000) Subject: Improve Doxygen docs for nested namespaces X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=633c66f0689894cf80b3ea993d49e392a8dd8c98;p=thirdparty%2Fgcc.git Improve Doxygen docs for nested namespaces * doc/doxygen/doxygroups.cc (std::tr2, std::__gnu_cxx): Improve docs. (std::experimental): Add docs. * doc/doxygen/user.cfg.in (PREDEFINED): Expand macros for __cxx11 namespace to nothing when generating docs. * include/bits/regex_constants.h (std::regex_constants): Improve docs. * include/std/chrono (std::chrono): Likewise. * include/std/functional (std::placeholders): Likewise. * include/std/thread (std::this_thread): Likewise. git-svn-id: svn+ssh://gcc.gnu.org/svn/gcc/trunk@270805 138bc75d-0d04-0410-961f-82ee72b054a4 --- diff --git a/libstdc++-v3/ChangeLog b/libstdc++-v3/ChangeLog index 0a018276cb37..a6469868368f 100644 --- a/libstdc++-v3/ChangeLog +++ b/libstdc++-v3/ChangeLog @@ -1,5 +1,14 @@ 2019-05-02 Jonathan Wakely + * doc/doxygen/doxygroups.cc (std::tr2, std::__gnu_cxx): Improve docs. + (std::experimental): Add docs. + * doc/doxygen/user.cfg.in (PREDEFINED): Expand macros for __cxx11 + namespace to nothing when generating docs. + * include/bits/regex_constants.h (std::regex_constants): Improve docs. + * include/std/chrono (std::chrono): Likewise. + * include/std/functional (std::placeholders): Likewise. + * include/std/thread (std::this_thread): Likewise. + * include/parallel/settings.h: Fix Doxygen markup. * include/ext/pb_ds/detail/bin_search_tree_/*_imps.hpp: Do not define diff --git a/libstdc++-v3/doc/doxygen/doxygroups.cc b/libstdc++-v3/doc/doxygen/doxygroups.cc index 6a6f6eb1d923..6822eac8070d 100644 --- a/libstdc++-v3/doc/doxygen/doxygroups.cc +++ b/libstdc++-v3/doc/doxygen/doxygroups.cc @@ -29,13 +29,15 @@ * @brief Implementation details not part of the namespace std::tr1 interface. */ /** @namespace std::tr2 - * @brief ISO C++ TR2 entities toplevel namespace is std::tr2. + * @brief Namespace for non-standard "TR2" extensions. + * @ingroup extensions */ /** @namespace std::tr2::__detail * @brief Implementation details not part of the namespace std::tr2 interface. */ /** @namespace __gnu_cxx * @brief GNU extensions for public use. + * @ingroup extensions */ /** @namespace __gnu_cxx::__detail * @brief Implementation details not part of the namespace __gnu_cxx @@ -45,6 +47,9 @@ * @brief GNU implemenation details, not for public use or * export. Used only when anonymous namespaces cannot be substituted. */ +/** @namespace std::experimental + * @brief Namespace for features defined in ISO Technical Specifications. + */ // // // // // // // // // // // // // // // // // // // // // // // // /** diff --git a/libstdc++-v3/doc/doxygen/user.cfg.in b/libstdc++-v3/doc/doxygen/user.cfg.in index 47fead334a10..c0b45b293c21 100644 --- a/libstdc++-v3/doc/doxygen/user.cfg.in +++ b/libstdc++-v3/doc/doxygen/user.cfg.in @@ -2265,10 +2265,12 @@ PREDEFINED = __cplusplus=201402L \ "_GLIBCXX_BEGIN_NAMESPACE_VERSION= " \ "_GLIBCXX_BEGIN_NAMESPACE_ALGO= " \ "_GLIBCXX_BEGIN_NAMESPACE_CONTAINER= " \ + "_GLIBCXX_BEGIN_NAMESPACE_CXX11= " \ "_GLIBCXX_BEGIN_NAMESPACE_LDBL= " \ "_GLIBCXX_END_NAMESPACE_VERSION= " \ "_GLIBCXX_END_NAMESPACE_ALGO= " \ "_GLIBCXX_END_NAMESPACE_CONTAINER= " \ + "_GLIBCXX_END_NAMESPACE_CXX11= " \ "_GLIBCXX_END_NAMESPACE_LDBL= " \ "_GLIBCXX_TEMPLATE_ARGS=... " \ _GLIBCXX_DEPRECATED \ @@ -2290,6 +2292,7 @@ PREDEFINED = __cplusplus=201402L \ PB_DS_DATA_TRUE_INDICATOR \ PB_DS_STATIC_ASSERT=// \ "_GLIBCXX_BEGIN_NAMESPACE_ALGO= " \ + "_GLIBCXX_END_NAMESPACE_ALGO= " \ __glibcxx_function_requires=// \ __glibcxx_class_requires=// \ __glibcxx_class_requires2=// \ diff --git a/libstdc++-v3/include/bits/regex_constants.h b/libstdc++-v3/include/bits/regex_constants.h index a7b51ddef20b..ba98d128e5e0 100644 --- a/libstdc++-v3/include/bits/regex_constants.h +++ b/libstdc++-v3/include/bits/regex_constants.h @@ -43,7 +43,7 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION /** * @namespace std::regex_constants - * @brief ISO C++-0x entities sub namespace for regex. + * @brief ISO C++ 2011 namespace for options and flags used with std::regex */ namespace regex_constants { diff --git a/libstdc++-v3/include/std/chrono b/libstdc++-v3/include/std/chrono index 9e63fa9c6984..1d6326cdd552 100644 --- a/libstdc++-v3/include/std/chrono +++ b/libstdc++-v3/include/std/chrono @@ -54,7 +54,7 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION */ /** @namespace std::chrono - * @brief ISO C++ 2011 entities sub-namespace for time and date. + * @brief ISO C++ 2011 namespace for date and time utilities */ namespace chrono { diff --git a/libstdc++-v3/include/std/functional b/libstdc++-v3/include/std/functional index 8cf2c670648e..0c290b9670b2 100644 --- a/libstdc++-v3/include/std/functional +++ b/libstdc++-v3/include/std/functional @@ -199,7 +199,7 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION template struct _Placeholder { }; /** @namespace std::placeholders - * @brief ISO C++11 entities sub-namespace for functional. + * @brief ISO C++ 2011 namespace for std::bind placeholders. * @ingroup binders */ namespace placeholders diff --git a/libstdc++-v3/include/std/thread b/libstdc++-v3/include/std/thread index 4eb744d41525..2da1101eecf9 100644 --- a/libstdc++-v3/include/std/thread +++ b/libstdc++-v3/include/std/thread @@ -328,8 +328,9 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION } /** @namespace std::this_thread - * @brief ISO C++ 2011 entities sub-namespace for thread. - * 30.3.2 Namespace this_thread. + * @brief ISO C++ 2011 namespace for interacting with the current thread + * + * C++11 30.3.2 [thread.thread.this] Namespace this_thread. */ namespace this_thread {