Improve API docs for Filesystem TS and Networking TS

* include/experimental/bits/fs_path.h: Improve docs.
	* include/experimental/bits/net.h: Fix wrong header name in comment.
	Do not document implementation details.
	* include/experimental/netfwd: Fix doxygen grouping.

From-SVN: r270990
This commit is contained in:
Jonathan Wakely 2019-05-08 00:22:01 +01:00 committed by Jonathan Wakely
parent 0e7bd559e4
commit 041aa6abe4
4 changed files with 29 additions and 16 deletions

View File

@ -1,3 +1,10 @@
2019-05-08 Jonathan Wakely <jwakely@redhat.com>
* include/experimental/bits/fs_path.h: Improve docs.
* include/experimental/bits/net.h: Fix wrong header name in comment.
Do not document implementation details.
* include/experimental/netfwd: Fix doxygen grouping.
2019-05-07 Jonathan Wakely <jwakely@redhat.com>
* include/bits/stl_pair.h: Improve docs.

View File

@ -514,8 +514,10 @@ _GLIBCXX_BEGIN_NAMESPACE_CXX11
/// @relates std::experimental::filesystem::path @{
/// Swap overload for paths
inline void swap(path& __lhs, path& __rhs) noexcept { __lhs.swap(__rhs); }
/// Compute a hash value for a path
size_t hash_value(const path& __p) noexcept;
/// Compare paths

View File

@ -24,7 +24,7 @@
/** @file experimental/bits/net.h
* This is an internal header file, included by other library headers.
* Do not attempt to use it directly. @headername{experimental/networking}
* Do not attempt to use it directly. @headername{experimental/net}
*/
#ifndef _GLIBCXX_EXPERIMENTAL_NET_H
@ -55,6 +55,8 @@ inline namespace v1
template<typename _CompletionToken, typename _Signature, typename>
class async_result;
/// @cond undocumented
// A type denoted by DEDUCED in the TS.
template<typename _CompletionToken, typename _Signature>
using __deduced_t = typename
@ -67,25 +69,27 @@ inline namespace v1
is_constructible<_Tp, _Tp&>, is_constructible<_Tp, const _Tp&&>
>::type;
struct __throw_on_error
struct __throw_on_error
{
explicit
__throw_on_error(const char* __msg) : _M_msg(__msg) { }
~__throw_on_error() noexcept(false)
{
explicit
__throw_on_error(const char* __msg) : _M_msg(__msg) { }
if (_M_ec)
_GLIBCXX_THROW_OR_ABORT(system_error(_M_ec, _M_msg));
}
~__throw_on_error() noexcept(false)
{
if (_M_ec)
_GLIBCXX_THROW_OR_ABORT(system_error(_M_ec, _M_msg));
}
__throw_on_error(const __throw_on_error&) = delete;
__throw_on_error& operator=(const __throw_on_error&) = delete;
__throw_on_error(const __throw_on_error&) = delete;
__throw_on_error& operator=(const __throw_on_error&) = delete;
operator error_code&() noexcept { return _M_ec; }
operator error_code&() noexcept { return _M_ec; }
const char* _M_msg;
error_code _M_ec;
};
const char* _M_msg;
error_code _M_ec;
};
/// @endcond
// Base class for types meeting IntegerSocketOption requirements.
template<typename _Tp>

View File

@ -96,7 +96,7 @@ inline namespace v1
namespace ip
{
/**
* @ingroup networking-ts
* @addtogroup networking-ts
* @{
*/
class address;