libstdc++: Use ///< for inline documentation

I noticed that some variables were misdocumented when using trailing
comment for documentation.  I ran a search with a relatively simple
regex[1] to look for any ///s following some code that did not have a <,
and came up with these instances only.

[1]: \s*([^  ]+\s*)+///[^<].*$

libstdc++-v3/ChangeLog:

	* include/std/iostream: Use ///< for inline documentation.
	* include/std/limits: Likewise.
	* include/experimental/internet: Likewise.

diff --git a/libstdc++-v3/include/experimental/internet b/libstdc++-v3/include/experimental/internet
index 6e3c355f38e2d73afa992c9a7c7f9e5fe85e0872..691198994e9d085833577b9fe4388b8b0074b292 100644 (file)
--- a/libstdc++-v3/include/experimental/internet
+++ b/libstdc++-v3/include/experimental/internet
@@ -2139,7 +2139,7 @@ namespace ip
     using resolver = basic_resolver<tcp>;       ///< A TCP resolver.
     using socket = basic_stream_socket<tcp>;    ///< A TCP socket.
     using acceptor = basic_socket_acceptor<tcp>; ///< A TCP acceptor.
-    using iostream = basic_socket_iostream<tcp>; /// A TCP iostream.
+    using iostream = basic_socket_iostream<tcp>; ///< A TCP iostream.
 
 #ifdef TCP_NODELAY
     /// Disable coalescing of small segments (i.e. the Nagle algorithm).

diff --git a/libstdc++-v3/include/std/iostream b/libstdc++-v3/include/std/iostream
index 685d29a32f4fdc72d455a5665772f639160e4031..02e9c3039d1a05c4ebc36e24d9d6edf173e7e7d1 100644 (file)
--- a/libstdc++-v3/include/std/iostream
+++ b/libstdc++-v3/include/std/iostream
@@ -59,16 +59,16 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
    *  manual linked to above.
   */
   ///@{
-  extern istream cin;          /// Linked to standard input
-  extern ostream cout;         /// Linked to standard output
-  extern ostream cerr;         /// Linked to standard error (unbuffered)
-  extern ostream clog;         /// Linked to standard error (buffered)
+  extern istream cin;          ///< Linked to standard input
+  extern ostream cout;         ///< Linked to standard output
+  extern ostream cerr;         ///< Linked to standard error (unbuffered)
+  extern ostream clog;         ///< Linked to standard error (buffered)
 
 #ifdef _GLIBCXX_USE_WCHAR_T
-  extern wistream wcin;                /// Linked to standard input
-  extern wostream wcout;       /// Linked to standard output
-  extern wostream wcerr;       /// Linked to standard error (unbuffered)
-  extern wostream wclog;       /// Linked to standard error (buffered)
+  extern wistream wcin;                ///< Linked to standard input
+  extern wostream wcout;       ///< Linked to standard output
+  extern wostream wcerr;       ///< Linked to standard error (unbuffered)
+  extern wostream wclog;       ///< Linked to standard error (buffered)
 #endif
   ///@}
 

diff --git a/libstdc++-v3/include/std/limits b/libstdc++-v3/include/std/limits
index 66201fa621533a682b6411956f20c8c6fdbba29a..a60611b1b1149d69cc5952ff4c9daaa4662906e3 100644 (file)
--- a/libstdc++-v3/include/std/limits
+++ b/libstdc++-v3/include/std/limits
@@ -166,11 +166,11 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
   */
   enum float_round_style
   {
-    round_indeterminate       = -1,    /// Intermediate.
-    round_toward_zero         = 0,     /// To zero.
-    round_to_nearest          = 1,     /// To the nearest representable value.
-    round_toward_infinity     = 2,     /// To infinity.
-    round_toward_neg_infinity = 3      /// To negative infinity.
+    round_indeterminate       = -1,    ///< Intermediate.
+    round_toward_zero         = 0,     ///< To zero.
+    round_to_nearest          = 1,     ///< To the nearest representable value.
+    round_toward_infinity     = 2,     ///< To infinity.
+    round_toward_neg_infinity = 3      ///< To negative infinity.
   };
 
   /**