doxygroups.cc: Add std::tr1 namespace.

2004-11-23  Benjamin Kosnik  <bkoz@redhat.com>

	* docs/doxygen/doxygroups.cc: Add std::tr1 namespace.
	* docs/doxygen/run_doxygen: Renames for std::tr1.
	* docs/doxygen/user.cfg.in: Add cxxabi.h.
	* include/bits/*.tcc: Add file markup.
	* include/bits/allocator.h: Add link to allocator.html.
	* include/bits/atomicity.h: Add file markup.
	* include/bits/concurrence.h: Same.
	* include/bits/functexcept.h: Same.
	* include/ext*: Adjust file markup, remove GCC3 bits.
	* include/std/*: Adjust file markup, remove bits about renamed files.
	* libsupc++/cxxabi.h: Add file markup.
	* testsuite/20_util/memory/auto_ptr/assign_neg.cc: Adjust line numbers.

From-SVN: r91135

libstdc++-v3/ChangeLog

+2004-11-23  Benjamin Kosnik  <bkoz@redhat.com>
+
+	* docs/doxygen/doxygroups.cc: Add std::tr1 namespace.
+	* docs/doxygen/run_doxygen: Renames for std::tr1.
+	* docs/doxygen/user.cfg.in: Add cxxabi.h.
+	* include/bits/*.tcc: Add file markup.
+	* include/bits/allocator.h: Add link to allocator.html.
+	* include/bits/atomicity.h: Add file markup.
+	* include/bits/concurrence.h: Same.
+	* include/bits/functexcept.h: Same.
+	* include/ext*: Adjust file markup, remove GCC3 bits.
+	* include/std/*: Adjust file markup, remove bits about renamed files.
+	* libsupc++/cxxabi.h: Add file markup.
+	* testsuite/20_util/memory/auto_ptr/assign_neg.cc: Adjust line numbers.
+
 2004-11-22  Benjamin Kosnik  <bkoz@redhat.com>
 
 	* include/bits/locale_facets.h (isspace, isprint, isupper,

libstdc++-v3/docs/doxygen/doxygroups.cc

@@ -19,6 +19,9 @@
 /** @namespace std
  *  @brief Everything defined by the ISO C++ Standard is within namespace std.
 */
+/** @namespace std::tr1
+ *  @brief Everything defined by the TR1 is within namespace std::tr1.
+*/
 /** @namespace __gnu_cxx
  *  @brief This namespace serves two purposes.
  *

libstdc++-v3/docs/doxygen/run_doxygen

@@ -282,6 +282,10 @@ cp ${srcdir}/docs/doxygen/Intro.3 C++Intro.3
 
 # Why didn't I do this at the start?  Were rabid weasels eating my brain?
 # Who the fsck would "man std_vector" when the class isn't named that?
+for f in std_tr1_*; do
+    newname=`echo $f | sed 's/^std_tr1_/std::tr1::/'`
+    mv $f $newname
+done
 for f in std_*; do
     newname=`echo $f | sed 's/^std_/std::/'`
     mv $f $newname

libstdc++-v3/docs/doxygen/user.cfg.in

@@ -76,6 +76,7 @@ INPUT                  = @srcdir@/docs/doxygen/doxygroups.cc \
                          @srcdir@/libsupc++/exception \
                          @srcdir@/libsupc++/new \
                          @srcdir@/libsupc++/typeinfo \
+                         @srcdir@/libsupc++/cxxabi.h \
                          include/algorithm \
                          include/bitset \
                          include/deque \
@@ -148,7 +149,8 @@ ALPHABETICAL_INDEX     = YES
 COLS_IN_ALPHA_INDEX    = 2
 IGNORE_PREFIX          = std \
                          __gnu_cxx \
-                         __gnu_debug
+                         __gnu_debug \
+	          	 std::tr1
 #---------------------------------------------------------------------------
 # configuration options related to the HTML output
 #---------------------------------------------------------------------------

libstdc++-v3/include/bits/allocator.h

@@ -56,6 +56,7 @@ namespace std
   template<typename _Tp>
     class allocator;
 
+  /// allocator<void> specialization.
   template<>
     class allocator<void>
     {
@@ -71,7 +72,12 @@ namespace std
         { typedef allocator<_Tp1> other; };
     };
 
-  /// @brief  The "standard" allocator, as per [20.4].
+  /**
+   * @brief  The "standard" allocator, as per [20.4].
+   *
+   *  Further details:
+   *  http://gcc.gnu.org/onlinedocs/libstdc++/20_util/allocator.html
+   */
   template<typename _Tp>
     class allocator: public ___glibcxx_base_allocator<_Tp>
     {

libstdc++-v3/include/bits/atomicity.h

@@ -27,6 +27,11 @@
 // invalidate any other reasons why the executable file might be covered by
 // the GNU General Public License.
 
+/** @file atomicity.h
+ *  This is an internal header file, included by other library headers.
+ *  You should not attempt to use it directly.
+ */
+
 #ifndef _GLIBCXX_ATOMICITY_H
 #define _GLIBCXX_ATOMICITY_H	1
 

libstdc++-v3/include/bits/basic_ios.tcc

@@ -27,6 +27,11 @@
 // invalidate any other reasons why the executable file might be covered by
 // the GNU General Public License.
 
+/** @file basic_ios.tcc
+ *  This is an internal header file, included by other library headers.
+ *  You should not attempt to use it directly.
+ */
+
 #ifndef _BASIC_IOS_TCC
 #define _BASIC_IOS_TCC 1
 

libstdc++-v3/include/bits/basic_string.tcc

@@ -28,13 +28,15 @@
 // invalidate any other reasons why the executable file might be covered by
 // the GNU General Public License.
 
+/** @file basic_string.tcc
+ *  This is an internal header file, included by other library headers.
+ *  You should not attempt to use it directly.
+ */
+
 //
 // ISO C++ 14882: 21  Strings library
 //
 
-// This file is included by <string>.  It is not meant to be included
-// separately.
-
 // Written by Jason Merrill based upon the specification by Takanori Adachi
 // in ANSI X3J16/94-0013R2.  Rewritten by Nathan Myers to ISO-14882.
 

libstdc++-v3/include/bits/concurrence.h

@@ -28,6 +28,11 @@
 // invalidate any other reasons why the executable file might be covered by
 // the GNU General Public License.
 
+/** @file concurrence.h
+ *  This is an internal header file, included by other library headers.
+ *  You should not attempt to use it directly.
+ */
+
 #ifndef _CONCURRENCE_H
 #define _CONCURRENCE_H 1
 

libstdc++-v3/include/bits/fstream.tcc

@@ -28,6 +28,11 @@
 // invalidate any other reasons why the executable file might be covered by
 // the GNU General Public License.
 
+/** @file fstream.tcc
+ *  This is an internal header file, included by other library headers.
+ *  You should not attempt to use it directly.
+ */
+
 //
 // ISO C++ 14882: 27.8  File-based streams
 //

libstdc++-v3/include/bits/functexcept.h

@@ -27,6 +27,10 @@
 // invalidate any other reasons why the executable file might be covered by
 // the GNU General Public License.
 
+/** @file functexcept.h
+ *  This header provides support for -fno-exceptions.
+ */
+
 //
 // ISO C++ 14882: 19.1  Exception classes
 //

libstdc++-v3/include/bits/istream.tcc

@@ -28,6 +28,11 @@
 // invalidate any other reasons why the executable file might be covered by
 // the GNU General Public License.
 
+/** @file istream.tcc
+ *  This is an internal header file, included by other library headers.
+ *  You should not attempt to use it directly.
+ */
+
 //
 // ISO C++ 14882: 27.6.1  Input streams
 //

libstdc++-v3/include/bits/locale_facets.tcc

@@ -28,7 +28,10 @@
 // invalidate any other reasons why the executable file might be covered by
 // the GNU General Public License.
 
-// Warning: this file is not meant for user inclusion. Use <locale>.
+/** @file locale_facets.tcc
+ *  This is an internal header file, included by other library headers.
+ *  You should not attempt to use it directly.
+ */
 
 #ifndef _LOCALE_FACETS_TCC
 #define _LOCALE_FACETS_TCC 1

libstdc++-v3/include/bits/ostream.tcc

@@ -28,6 +28,11 @@
 // invalidate any other reasons why the executable file might be covered by
 // the GNU General Public License.
 
+/** @file ostream.tcc
+ *  This is an internal header file, included by other library headers.
+ *  You should not attempt to use it directly.
+ */
+
 //
 // ISO C++ 14882: 27.6.2  Output streams
 //

libstdc++-v3/include/bits/sstream.tcc

@@ -28,6 +28,11 @@
 // invalidate any other reasons why the executable file might be covered by
 // the GNU General Public License.
 
+/** @file sstream.tcc
+ *  This is an internal header file, included by other library headers.
+ *  You should not attempt to use it directly.
+ */
+
 //
 // ISO C++ 14882: 27.7  String-based streams
 //

libstdc++-v3/include/bits/streambuf.tcc

@@ -28,6 +28,11 @@
 // invalidate any other reasons why the executable file might be covered by
 // the GNU General Public License.
 
+/** @file streambuf.tcc
+ *  This is an internal header file, included by other library headers.
+ *  You should not attempt to use it directly.
+ */
+
 //
 // ISO C++ 14882: 27.5  Stream buffers
 //

libstdc++-v3/include/bits/valarray_array.tcc

@@ -27,6 +27,11 @@
 // invalidate any other reasons why the executable file might be covered by
 // the GNU General Public License.
 
+/** @file valarray_array.tcc
+ *  This is an internal header file, included by other library headers.
+ *  You should not attempt to use it directly.
+ */
+
 // Written by Gabriel Dos Reis <Gabriel.Dos-Reis@DPTMaths.ENS-Cachan.Fr>
 
 #ifndef _VALARRAY_ARRAY_TCC

libstdc++-v3/include/ext/algorithm

@@ -55,8 +55,7 @@
 
 /** @file ext/algorithm
  *  This file is a GNU extension to the Standard C++ Library (possibly
- *  containing extensions from the HP/SGI STL subset).  You should only
- *  include this header if you are using GCC 3 or later.
+ *  containing extensions from the HP/SGI STL subset).
  */
 
 #ifndef _EXT_ALGORITHM

libstdc++-v3/include/ext/array_allocator.h

@@ -27,6 +27,10 @@
 // invalidate any other reasons why the executable file might be covered by
 // the GNU General Public License.
 
+/** @file ext/array_allocator.h
+ *  This file is a GNU extension to the Standard C++ Library.
+ */
+
 #ifndef _ARRAY_ALLOCATOR_H
 #define _ARRAY_ALLOCATOR_H 1
 

libstdc++-v3/include/ext/bitmap_allocator.h

@@ -29,7 +29,6 @@
 
 /** @file ext/bitmap_allocator.h
  *  This file is a GNU extension to the Standard C++ Library.
- *  You should only include this header if you are using GCC 3 or later.
  */
 
 #ifndef _BITMAP_ALLOCATOR_H

libstdc++-v3/include/ext/functional

@@ -55,8 +55,7 @@
 
 /** @file ext/functional
  *  This file is a GNU extension to the Standard C++ Library (possibly
- *  containing extensions from the HP/SGI STL subset).  You should only
- *  include this header if you are using GCC 3 or later.
+ *  containing extensions from the HP/SGI STL subset).
  */
 
 #ifndef _EXT_FUNCTIONAL

libstdc++-v3/include/ext/hash_fun.h

@@ -55,8 +55,7 @@
 
 /** @file ext/hash_fun.h
  *  This file is a GNU extension to the Standard C++ Library (possibly
- *  containing extensions from the HP/SGI STL subset).  You should only
- *  include this header if you are using GCC 3 or later.
+ *  containing extensions from the HP/SGI STL subset).
  */
 
 #ifndef _HASH_FUN_H

libstdc++-v3/include/ext/hash_map

@@ -55,8 +55,7 @@
 
 /** @file ext/hash_map
  *  This file is a GNU extension to the Standard C++ Library (possibly
- *  containing extensions from the HP/SGI STL subset).  You should only
- *  include this header if you are using GCC 3 or later.
+ *  containing extensions from the HP/SGI STL subset).
  */
 
 #ifndef _HASH_MAP

libstdc++-v3/include/ext/hash_set

@@ -55,8 +55,7 @@
 
 /** @file ext/hash_set
  *  This file is a GNU extension to the Standard C++ Library (possibly
- *  containing extensions from the HP/SGI STL subset).  You should only
- *  include this header if you are using GCC 3 or later.
+ *  containing extensions from the HP/SGI STL subset).
  */
 
 #ifndef _HASH_SET

libstdc++-v3/include/ext/hashtable.h

@@ -55,8 +55,7 @@
 
 /** @file ext/hashtable.h
  *  This file is a GNU extension to the Standard C++ Library (possibly
- *  containing extensions from the HP/SGI STL subset).  You should only
- *  include this header if you are using GCC 3 or later.
+ *  containing extensions from the HP/SGI STL subset).
  */
 
 #ifndef _HASHTABLE_H

libstdc++-v3/include/ext/iterator

@@ -55,8 +55,7 @@
 
 /** @file ext/iterator
  *  This file is a GNU extension to the Standard C++ Library (possibly
- *  containing extensions from the HP/SGI STL subset).  You should only
- *  include this header if you are using GCC 3 or later.
+ *  containing extensions from the HP/SGI STL subset).
  */
 
 #ifndef _EXT_ITERATOR

libstdc++-v3/include/ext/malloc_allocator.h

@@ -27,6 +27,10 @@
 // invalidate any other reasons why the executable file might be covered by
 // the GNU General Public License.
 
+/** @file ext/malloc_allocator.h
+ *  This file is a GNU extension to the Standard C++ Library.
+ */
+
 #ifndef _MALLOC_ALLOCATOR_H
 #define _MALLOC_ALLOCATOR_H 1
 
@@ -36,7 +40,7 @@
 namespace __gnu_cxx
 {
   /**
-   *  @brief  An allocator that uses malloc
+   *  @brief  An allocator that uses malloc.
    *
    *  This is precisely the allocator defined in the C++ Standard. 
    *    - all allocation calls malloc

libstdc++-v3/include/ext/memory

@@ -55,8 +55,7 @@
 
 /** @file ext/memory
  *  This file is a GNU extension to the Standard C++ Library (possibly
- *  containing extensions from the HP/SGI STL subset).  You should only
- *  include this header if you are using GCC 3 or later.
+ *  containing extensions from the HP/SGI STL subset).
  */
 
 #ifndef _EXT_MEMORY

libstdc++-v3/include/ext/mt_allocator.h

@@ -29,7 +29,6 @@
 
 /** @file ext/mt_allocator.h
  *  This file is a GNU extension to the Standard C++ Library.
- *  You should only include this header if you are using GCC 3 or later.
  */
 
 #ifndef _MT_ALLOCATOR_H

libstdc++-v3/include/ext/new_allocator.h

@@ -27,6 +27,10 @@
 // invalidate any other reasons why the executable file might be covered by
 // the GNU General Public License.
 
+/** @file ext/new_allocator.h
+ *  This file is a GNU extension to the Standard C++ Library.
+ */
+
 #ifndef _NEW_ALLOCATOR_H
 #define _NEW_ALLOCATOR_H 1
 

libstdc++-v3/include/ext/numeric

@@ -55,8 +55,7 @@
 
 /** @file ext/numeric
  *  This file is a GNU extension to the Standard C++ Library (possibly
- *  containing extensions from the HP/SGI STL subset).  You should only
- *  include this header if you are using GCC 3 or later.
+ *  containing extensions from the HP/SGI STL subset). 
  */
 
 #ifndef _EXT_NUMERIC

libstdc++-v3/include/ext/pod_char_traits.h

 // POD character, std::char_traits specialization -*- C++ -*-
 
-// Copyright (C) 2002, 2003 Free Software Foundation, Inc.
+// Copyright (C) 2002, 2003, 2004 Free Software Foundation, Inc.
 //
 // This file is part of the GNU ISO C++ Library.  This library is free
 // software; you can redistribute it and/or modify it under the
@@ -27,6 +27,10 @@
 // invalidate any other reasons why the executable file might be covered by
 // the GNU General Public License.
 
+/** @file ext/pod_char_traits.h
+ *  This file is a GNU extension to the Standard C++ Library.
+ */
+
 // Gabriel Dos Reis <gdr@integrable-solutions.net>
 // Benjamin Kosnik <bkoz@redhat.com>
 
@@ -37,6 +41,7 @@
 
 namespace __gnu_cxx
 {
+  /// @brief A POD class that serves as a character abstraction class.
   template<typename V, typename I, typename S = mbstate_t>
     struct character
     {
@@ -59,7 +64,7 @@ namespace __gnu_cxx
 
 namespace std
 {
-  // Provide std::char_traits specialization.
+  /// char_traits<__gnu_cxx::character> specialization.
   template<typename V, typename I, typename S>
     struct char_traits<__gnu_cxx::character<V, I, S> >
     {

libstdc++-v3/include/ext/pool_allocator.h

@@ -42,8 +42,8 @@
 
 /** @file ext/pool_allocator.h
  *  This file is a GNU extension to the Standard C++ Library.
- *  You should only include this header if you are using GCC 3 or later.
  */
+
 #ifndef _POOL_ALLOCATOR_H
 #define _POOL_ALLOCATOR_H 1
 
@@ -117,7 +117,7 @@ namespace __gnu_cxx
     };
 
 
-  /// @brief  Class __pool_alloc.
+  /// @brief  class __pool_alloc.
   template<typename _Tp>
     class __pool_alloc : private __pool_alloc_base
     {

libstdc++-v3/include/ext/rb_tree

@@ -55,8 +55,7 @@
 
 /** @file ext/rb_tree
  *  This file is a GNU extension to the Standard C++ Library (possibly
- *  containing extensions from the HP/SGI STL subset).  You should only
- *  include this header if you are using GCC 3 or later.
+ *  containing extensions from the HP/SGI STL subset). 
  */
 
 #ifndef _RB_TREE

libstdc++-v3/include/ext/rope

@@ -42,8 +42,7 @@
 
 /** @file ext/rope
  *  This file is a GNU extension to the Standard C++ Library (possibly
- *  containing extensions from the HP/SGI STL subset).  You should only
- *  include this header if you are using GCC 3 or later.
+ *  containing extensions from the HP/SGI STL subset). 
  */
 
 #ifndef _ROPE

libstdc++-v3/include/ext/slist

@@ -43,8 +43,7 @@
 
 /** @file ext/slist
  *  This file is a GNU extension to the Standard C++ Library (possibly
- *  containing extensions from the HP/SGI STL subset).  You should only
- *  include this header if you are using GCC 3 or later.
+ *  containing extensions from the HP/SGI STL subset). 
  */
 
 #ifndef _SLIST

libstdc++-v3/include/std/std_algorithm.h

@@ -54,8 +54,7 @@
  */
 
 /** @file
- *  This is a Standard C++ Library header.  You should @c #include this header
- *  in your programs, rather than any of the "st[dl]_*.h" implementation files.
+ *  This is a Standard C++ Library header.
  */
 
 #ifndef _GLIBCXX_ALGORITHM

libstdc++-v3/include/std/std_bitset.h

@@ -41,8 +41,7 @@
  */
 
 /** @file bitset
- *  This is a Standard C++ Library header.  You should @c #include this header
- *  in your programs, rather than any of the "st[dl]_*.h" implementation files.
+ *  This is a Standard C++ Library header.
  */
 
 #ifndef _GLIBCXX_BITSET

libstdc++-v3/include/std/std_complex.h

@@ -36,8 +36,7 @@
 //
 
 /** @file complex
- *  This is a Standard C++ Library header.  You should @c #include this header
- *  in your programs, rather than any of the "st[dl]_*.h" implementation files.
+ *  This is a Standard C++ Library header.
  */
 
 #ifndef _GLIBCXX_COMPLEX

libstdc++-v3/include/std/std_deque.h

@@ -54,8 +54,7 @@
  */
 
 /** @file deque
- *  This is a Standard C++ Library header.  You should @c #include this header
- *  in your programs, rather than any of the "st[dl]_*.h" implementation files.
+ *  This is a Standard C++ Library header.
  */
 
 #ifndef _GLIBCXX_DEQUE

libstdc++-v3/include/std/std_fstream.h

@@ -33,8 +33,7 @@
 //
 
 /** @file fstream
- *  This is a Standard C++ Library header.  You should @c #include this header
- *  in your programs, rather than any of the "st[dl]_*.h" implementation files.
+ *  This is a Standard C++ Library header.
  */
 
 #ifndef _GLIBCXX_FSTREAM

libstdc++-v3/include/std/std_functional.h

@@ -42,8 +42,7 @@
  */
 
 /** @file
- *  This is a Standard C++ Library header.  You should @c #include this header
- *  in your programs, rather than any of the "st[dl]_*.h" implementation files.
+ *  This is a Standard C++ Library header.
  */
 
 #ifndef _GLIBCXX_FUNCTIONAL

libstdc++-v3/include/std/std_iomanip.h

@@ -33,8 +33,7 @@
 //
 
 /** @file iomanip
- *  This is a Standard C++ Library header.  You should @c #include this header
- *  in your programs, rather than any of the "st[dl]_*.h" implementation files.
+ *  This is a Standard C++ Library header.
  */
 
 #ifndef _GLIBCXX_IOMANIP

libstdc++-v3/include/std/std_ios.h

@@ -32,8 +32,7 @@
 //
 
 /** @file ios
- *  This is a Standard C++ Library header.  You should @c #include this header
- *  in your programs, rather than any of the "st[dl]_*.h" implementation files.
+ *  This is a Standard C++ Library header.
  */
 
 #ifndef _GLIBCXX_IOS

libstdc++-v3/include/std/std_iosfwd.h

@@ -33,8 +33,7 @@
 //
 
 /** @file iosfwd
- *  This is a Standard C++ Library header.  You should @c #include this header
- *  in your programs, rather than any of the "st[dl]_*.h" implementation files.
+ *  This is a Standard C++ Library header.
  */
 
 #ifndef _GLIBCXX_IOSFWD

libstdc++-v3/include/std/std_iostream.h

@@ -32,8 +32,7 @@
 //
 
 /** @file iostream
- *  This is a Standard C++ Library header.  You should @c #include this header
- *  in your programs, rather than any of the "st[dl]_*.h" implementation files.
+ *  This is a Standard C++ Library header. 
  */
 
 #ifndef _GLIBCXX_IOSTREAM

libstdc++-v3/include/std/std_istream.h

@@ -33,8 +33,7 @@
 //
 
 /** @file istream
- *  This is a Standard C++ Library header.  You should @c #include this header
- *  in your programs, rather than any of the "st[dl]_*.h" implementation files.
+ *  This is a Standard C++ Library header.
  */
 
 #ifndef _GLIBCXX_ISTREAM

libstdc++-v3/include/std/std_iterator.h

@@ -54,8 +54,7 @@
  */
 
 /** @file iterator
- *  This is a Standard C++ Library header.  You should @c #include this header
- *  in your programs, rather than any of the "st[dl]_*.h" implementation files.
+ *  This is a Standard C++ Library header.
  */
 
 #ifndef _GLIBCXX_ITERATOR

libstdc++-v3/include/std/std_limits.h

@@ -27,6 +27,10 @@
 // invalidate any other reasons why the executable file might be covered by
 // the GNU General Public License.
 
+/** @file limits
+ *  This is a Standard C++ Library header.
+ */
+
 // Note: this is not a conforming implementation.
 // Written by Gabriel Dos Reis <gdr@codesourcery.com>
 
@@ -35,11 +39,6 @@
 // 18.2.1
 //
 
-/** @file limits
- *  This is a Standard C++ Library header.  You should @c #include this header
- *  in your programs, rather than any of the "st[dl]_*.h" implementation files.
- */
-
 #ifndef _GLIBCXX_NUMERIC_LIMITS
 #define _GLIBCXX_NUMERIC_LIMITS 1
 
@@ -310,6 +309,8 @@ namespace std
 
   // Now there follow 15 explicit specializations.  Yes, 15.  Make sure
   // you get the count right.
+
+  /// numeric_limits<bool> specialization.
   template<>
     struct numeric_limits<bool>
     {
@@ -363,6 +364,7 @@ namespace std
       static const float_round_style round_style = round_toward_zero;
     };
 
+  /// numeric_limits<char> specialization.
   template<>
     struct numeric_limits<char>
     {
@@ -413,6 +415,7 @@ namespace std
       static const float_round_style round_style = round_toward_zero;
     };
 
+  /// numeric_limits<signed char> specialization.
   template<>
     struct numeric_limits<signed char>
     {
@@ -463,6 +466,7 @@ namespace std
       static const float_round_style round_style = round_toward_zero;
     };
 
+  /// numeric_limits<unsigned char> specialization.
   template<>
     struct numeric_limits<unsigned char>
     {
@@ -513,6 +517,7 @@ namespace std
       static const float_round_style round_style = round_toward_zero;
     };
 
+  /// numeric_limits<wchar_t> specialization.
   template<>
     struct numeric_limits<wchar_t>
     {
@@ -563,6 +568,7 @@ namespace std
       static const float_round_style round_style = round_toward_zero;
     };
 
+  /// numeric_limits<short> specialization.
   template<>
     struct numeric_limits<short>
     {
@@ -613,6 +619,7 @@ namespace std
       static const float_round_style round_style = round_toward_zero;
     };
 
+  /// numeric_limits<unsigned short> specialization.
   template<>
     struct numeric_limits<unsigned short>
     {
@@ -663,6 +670,7 @@ namespace std
       static const float_round_style round_style = round_toward_zero;
     };
 
+  /// numeric_limits<int> specialization.
   template<>
     struct numeric_limits<int>
     {
@@ -713,6 +721,7 @@ namespace std
       static const float_round_style round_style = round_toward_zero;
     };
 
+  /// numeric_limits<unsigned int> specialization.
   template<>
     struct numeric_limits<unsigned int>
     {
@@ -763,6 +772,7 @@ namespace std
       static const float_round_style round_style = round_toward_zero;
     };
 
+  /// numeric_limits<long> specialization.
   template<>
     struct numeric_limits<long>
     {
@@ -813,6 +823,7 @@ namespace std
       static const float_round_style round_style = round_toward_zero;
     };
 
+  /// numeric_limits<unsigned long> specialization.
   template<>
     struct numeric_limits<unsigned long>
     {
@@ -863,6 +874,7 @@ namespace std
       static const float_round_style round_style = round_toward_zero;
     };
 
+  /// numeric_limits<long long> specialization.
   template<>
     struct numeric_limits<long long>
     {
@@ -913,6 +925,7 @@ namespace std
       static const float_round_style round_style = round_toward_zero;
     };
 
+  /// numeric_limits<unsigned long long> specialization.
   template<>
     struct numeric_limits<unsigned long long>
     {
@@ -963,6 +976,7 @@ namespace std
       static const float_round_style round_style = round_toward_zero;
     };
 
+  /// numeric_limits<float> specialization.
   template<>
     struct numeric_limits<float>
     {
@@ -1019,6 +1033,7 @@ namespace std
 #undef __glibcxx_float_traps
 #undef __glibcxx_float_tinyness_before
 
+  /// numeric_limits<double> specialization.
   template<>
     struct numeric_limits<double>
     {
@@ -1075,6 +1090,7 @@ namespace std
 #undef __glibcxx_double_traps
 #undef __glibcxx_double_tinyness_before
 
+  /// numeric_limits<long double> specialization.
   template<>
     struct numeric_limits<long double>
     {

libstdc++-v3/include/std/std_list.h

@@ -54,8 +54,7 @@
  */
 
 /** @file list
- *  This is a Standard C++ Library header.  You should @c #include this header
- *  in your programs, rather than any of the "st[dl]_*.h" implementation files.
+ *  This is a Standard C++ Library header.
  */
 
 #ifndef _GLIBCXX_LIST

libstdc++-v3/include/std/std_locale.h

@@ -32,8 +32,7 @@
 //
 
 /** @file locale
- *  This is a Standard C++ Library header.  You should @c #include this header
- *  in your programs, rather than any of the "st[dl]_*.h" implementation files.
+ *  This is a Standard C++ Library header.
  */
 
 #ifndef _GLIBCXX_LOCALE

libstdc++-v3/include/std/std_map.h

@@ -54,8 +54,7 @@
  */
 
 /** @file map
- *  This is a Standard C++ Library header.  You should @c #include this header
- *  in your programs, rather than any of the "st[dl]_*.h" implementation files.
+ *  This is a Standard C++ Library header.
  */
 
 #ifndef _GLIBCXX_MAP

libstdc++-v3/include/std/std_memory.h

@@ -42,8 +42,7 @@
  */
 
 /** @file
- *  This is a Standard C++ Library header.  You should @c #include this header
- *  in your programs, rather than any of the "st[dl]_*.h" implementation files.
+ *  This is a Standard C++ Library header.
  */
 
 #ifndef _GLIBCXX_MEMORY

libstdc++-v3/include/std/std_numeric.h

@@ -54,8 +54,7 @@
  */
 
 /** @file
- *  This is a Standard C++ Library header.  You should @c #include this header
- *  in your programs, rather than any of the "st[dl]_*.h" implementation files.
+ *  This is a Standard C++ Library header.
  */
 
 #ifndef _GLIBCXX_NUMERIC

libstdc++-v3/include/std/std_ostream.h

@@ -33,8 +33,7 @@
 //
 
 /** @file ostream
- *  This is a Standard C++ Library header.  You should @c #include this header
- *  in your programs, rather than any of the "st[dl]_*.h" implementation files.
+ *  This is a Standard C++ Library header.
  */
 
 #ifndef _GLIBCXX_OSTREAM

libstdc++-v3/include/std/std_queue.h

@@ -54,8 +54,7 @@
  */
 
 /** @file queue
- *  This is a Standard C++ Library header.  You should @c #include this header
- *  in your programs, rather than any of the "st[dl]_*.h" implementation files.
+ *  This is a Standard C++ Library header.
  */
 
 #ifndef _GLIBCXX_QUEUE

libstdc++-v3/include/std/std_set.h

@@ -54,8 +54,7 @@
  */
 
 /** @file set
- *  This is a Standard C++ Library header.  You should @c #include this header
- *  in your programs, rather than any of the "st[dl]_*.h" implementation files.
+ *  This is a Standard C++ Library header.
  */
 
 #ifndef _GLIBCXX_SET

libstdc++-v3/include/std/std_sstream.h

@@ -33,8 +33,7 @@
 //
 
 /** @file sstream
- *  This is a Standard C++ Library header.  You should @c #include this header
- *  in your programs, rather than any of the "st[dl]_*.h" implementation files.
+ *  This is a Standard C++ Library header.
  */
 
 #ifndef _GLIBCXX_SSTREAM

libstdc++-v3/include/std/std_stack.h

@@ -54,8 +54,7 @@
  */
 
 /** @file stack
- *  This is a Standard C++ Library header.  You should @c #include this header
- *  in your programs, rather than any of the "st[dl]_*.h" implementation files.
+ *  This is a Standard C++ Library header.
  */
 
 #ifndef _GLIBCXX_STACK

libstdc++-v3/include/std/std_stdexcept.h

@@ -32,8 +32,7 @@
 //
 
 /** @file stdexcept
- *  This is a Standard C++ Library header.  You should @c #include this header
- *  in your programs, rather than any of the "st[dl]_*.h" implementation files.
+ *  This is a Standard C++ Library header.
  */
 
 #ifndef _GLIBCXX_STDEXCEPT

libstdc++-v3/include/std/std_streambuf.h

@@ -33,8 +33,7 @@
 //
 
 /** @file streambuf
- *  This is a Standard C++ Library header.  You should @c #include this header
- *  in your programs, rather than any of the "st[dl]_*.h" implementation files.
+ *  This is a Standard C++ Library header.
  */
 
 #ifndef _GLIBXX_STREAMBUF

libstdc++-v3/include/std/std_string.h

@@ -33,8 +33,7 @@
 //
 
 /** @file string
- *  This is a Standard C++ Library header.  You should @c #include this header
- *  in your programs, rather than any of the "st[dl]_*.h" implementation files.
+ *  This is a Standard C++ Library header.
  */
 
 #ifndef _GLIBCXX_STRING

libstdc++-v3/include/std/std_utility.h

@@ -54,8 +54,7 @@
  */
 
 /** @file utility
- *  This is a Standard C++ Library header.  You should @c #include this header
- *  in your programs, rather than any of the "st[dl]_*.h" implementation files.
+ *  This is a Standard C++ Library header. 
  */
 
 #ifndef _GLIBCXX_UTILITY

libstdc++-v3/include/std/std_valarray.h

@@ -31,8 +31,7 @@
 // Written by Gabriel Dos Reis <Gabriel.Dos-Reis@DPTMaths.ENS-Cachan.Fr>
 
 /** @file valarray
- *  This is a Standard C++ Library header.  You should @c #include this header
- *  in your programs, rather than any of the "st[dl]_*.h" implementation files.
+ *  This is a Standard C++ Library header. 
  */
 
 #ifndef _GLIBCXX_VALARRAY

libstdc++-v3/include/std/std_vector.h

@@ -54,8 +54,7 @@
  */
 
 /** @file vector
- *  This is a Standard C++ Library header.  You should @c #include this header
- *  in your programs, rather than any of the "st[dl]_*.h" implementation files.
+ *  This is a Standard C++ Library header.
  */
 
 #ifndef _GLIBCXX_VECTOR

libstdc++-v3/libsupc++/cxxabi.h

@@ -39,6 +39,10 @@
    is includable from both C and C++. Though the C++ specific parts are not
    available in C, naturally enough.  */
 
+/** @file cxxabi.h
+ *  The header provides an interface to the C++ ABI.
+ */
+
 #ifndef _CXXABI_H
 #define _CXXABI_H 1
 

libstdc++-v3/testsuite/20_util/memory/auto_ptr/assign_neg.cc

@@ -46,5 +46,5 @@ main()
   test01();
   return 0;
 }
-// { dg-error "candidates" "" { target *-*-* } 224 } 
-// { dg-error "std::auto_ptr" "" { target *-*-* } 354 } 
+// { dg-error "candidates" "" { target *-*-* } 223 } 
+// { dg-error "std::auto_ptr" "" { target *-*-* } 353 }