OSDN Git Service

2010-11-18 Benjamin Kosnik <bkoz@redhat.com>
authorbkoz <bkoz@138bc75d-0d04-0410-961f-82ee72b054a4>
Sun, 19 Dec 2010 09:21:16 +0000 (09:21 +0000)
committerbkoz <bkoz@138bc75d-0d04-0410-961f-82ee72b054a4>
Sun, 19 Dec 2010 09:21:16 +0000 (09:21 +0000)
* config/*/*: Use headername alias to associate private includes
to public includes.
* include/*/*: Same.

* scripts/run_doxygen: Update for doxygen 1.7.2.
* doc/doxygen/user.cfg.in: Same.
* doc/doxygen/TODO: Remove.

* testsuite/*/std_c++0x_neg.cc: Adjust line number.

git-svn-id: svn+ssh://gcc.gnu.org/svn/gcc/trunk@168046 138bc75d-0d04-0410-961f-82ee72b054a4

257 files changed:
libstdc++-v3/ChangeLog
libstdc++-v3/config/allocator/bitmap_allocator_base.h
libstdc++-v3/config/allocator/malloc_allocator_base.h
libstdc++-v3/config/allocator/mt_allocator_base.h
libstdc++-v3/config/allocator/new_allocator_base.h
libstdc++-v3/config/allocator/pool_allocator_base.h
libstdc++-v3/config/cpu/generic/atomicity_builtins/atomicity.h
libstdc++-v3/config/cpu/generic/atomicity_mutex/atomicity.h
libstdc++-v3/config/cpu/generic/cpu_defines.h
libstdc++-v3/config/cpu/microblaze/cpu_defines.h
libstdc++-v3/config/cpu/powerpc/cpu_defines.h
libstdc++-v3/config/io/basic_file_stdio.h
libstdc++-v3/config/io/c_io_stdio.h
libstdc++-v3/config/locale/generic/c_locale.h
libstdc++-v3/config/locale/generic/messages_members.h
libstdc++-v3/config/locale/generic/time_members.h
libstdc++-v3/config/locale/gnu/c++locale_internal.h
libstdc++-v3/config/locale/gnu/c_locale.h
libstdc++-v3/config/locale/gnu/messages_members.h
libstdc++-v3/config/locale/gnu/time_members.h
libstdc++-v3/config/locale/ieee_1003.1-2001/c_locale.h
libstdc++-v3/config/locale/ieee_1003.1-2001/messages_members.h
libstdc++-v3/config/os/aix/atomic_word.h
libstdc++-v3/config/os/aix/ctype_inline.h
libstdc++-v3/config/os/aix/ctype_noninline.h
libstdc++-v3/config/os/aix/os_defines.h
libstdc++-v3/config/os/bionic/ctype_inline.h
libstdc++-v3/config/os/bionic/ctype_noninline.h
libstdc++-v3/config/os/bionic/os_defines.h
libstdc++-v3/config/os/bsd/darwin/ctype_inline.h
libstdc++-v3/config/os/bsd/darwin/ctype_noninline.h
libstdc++-v3/config/os/bsd/freebsd/ctype_base.h
libstdc++-v3/config/os/bsd/freebsd/ctype_inline.h
libstdc++-v3/config/os/bsd/freebsd/ctype_noninline.h
libstdc++-v3/config/os/bsd/netbsd/ctype_inline.h
libstdc++-v3/config/os/bsd/netbsd/ctype_noninline.h
libstdc++-v3/config/os/djgpp/ctype_inline.h
libstdc++-v3/config/os/djgpp/ctype_noninline.h
libstdc++-v3/config/os/djgpp/error_constants.h
libstdc++-v3/config/os/djgpp/os_defines.h
libstdc++-v3/config/os/generic/ctype_base.h
libstdc++-v3/config/os/generic/ctype_inline.h
libstdc++-v3/config/os/generic/ctype_noninline.h
libstdc++-v3/config/os/generic/error_constants.h
libstdc++-v3/config/os/generic/os_defines.h
libstdc++-v3/config/os/gnu-linux/ctype_base.h
libstdc++-v3/config/os/gnu-linux/ctype_inline.h
libstdc++-v3/config/os/gnu-linux/ctype_noninline.h
libstdc++-v3/config/os/gnu-linux/os_defines.h
libstdc++-v3/config/os/hpux/ctype_inline.h
libstdc++-v3/config/os/hpux/ctype_noninline.h
libstdc++-v3/config/os/hpux/os_defines.h
libstdc++-v3/config/os/irix/atomic_word.h
libstdc++-v3/config/os/irix/irix6.5/ctype_base.h
libstdc++-v3/config/os/irix/irix6.5/ctype_inline.h
libstdc++-v3/config/os/irix/irix6.5/ctype_noninline.h
libstdc++-v3/config/os/irix/irix6.5/os_defines.h
libstdc++-v3/config/os/mingw32/ctype_inline.h
libstdc++-v3/config/os/mingw32/ctype_noninline.h
libstdc++-v3/config/os/mingw32/error_constants.h
libstdc++-v3/config/os/mingw32/os_defines.h
libstdc++-v3/config/os/newlib/ctype_inline.h
libstdc++-v3/config/os/newlib/ctype_noninline.h
libstdc++-v3/config/os/newlib/os_defines.h
libstdc++-v3/config/os/qnx/qnx6.1/ctype_base.h
libstdc++-v3/config/os/qnx/qnx6.1/ctype_inline.h
libstdc++-v3/config/os/qnx/qnx6.1/ctype_noninline.h
libstdc++-v3/config/os/solaris/solaris2.7/ctype_inline.h
libstdc++-v3/config/os/solaris/solaris2.7/ctype_noninline.h
libstdc++-v3/config/os/tpf/ctype_inline.h
libstdc++-v3/config/os/tpf/ctype_noninline.h
libstdc++-v3/config/os/tpf/os_defines.h
libstdc++-v3/config/os/uclibc/ctype_base.h
libstdc++-v3/config/os/uclibc/ctype_inline.h
libstdc++-v3/config/os/uclibc/ctype_noninline.h
libstdc++-v3/config/os/uclibc/os_defines.h
libstdc++-v3/config/os/vxworks/ctype_inline.h
libstdc++-v3/config/os/vxworks/ctype_noninline.h
libstdc++-v3/config/os/vxworks/os_defines.h
libstdc++-v3/doc/doxygen/TODO [deleted file]
libstdc++-v3/doc/doxygen/user.cfg.in
libstdc++-v3/include/bits/algorithmfwd.h
libstdc++-v3/include/bits/allocator.h
libstdc++-v3/include/bits/atomic_0.h
libstdc++-v3/include/bits/atomic_2.h
libstdc++-v3/include/bits/atomic_base.h
libstdc++-v3/include/bits/basic_ios.h
libstdc++-v3/include/bits/basic_ios.tcc
libstdc++-v3/include/bits/basic_string.h
libstdc++-v3/include/bits/basic_string.tcc
libstdc++-v3/include/bits/boost_concept_check.h
libstdc++-v3/include/bits/c++0x_warning.h
libstdc++-v3/include/bits/c++config
libstdc++-v3/include/bits/char_traits.h
libstdc++-v3/include/bits/codecvt.h
libstdc++-v3/include/bits/concept_check.h
libstdc++-v3/include/bits/cpp_type_traits.h
libstdc++-v3/include/bits/deque.tcc
libstdc++-v3/include/bits/forward_list.h
libstdc++-v3/include/bits/forward_list.tcc
libstdc++-v3/include/bits/fstream.tcc
libstdc++-v3/include/bits/functexcept.h
libstdc++-v3/include/bits/functional_hash.h
libstdc++-v3/include/bits/gslice.h
libstdc++-v3/include/bits/gslice_array.h
libstdc++-v3/include/bits/hashtable.h
libstdc++-v3/include/bits/hashtable_policy.h
libstdc++-v3/include/bits/indirect_array.h
libstdc++-v3/include/bits/ios_base.h
libstdc++-v3/include/bits/istream.tcc
libstdc++-v3/include/bits/list.tcc
libstdc++-v3/include/bits/locale_classes.h
libstdc++-v3/include/bits/locale_classes.tcc
libstdc++-v3/include/bits/locale_facets.h
libstdc++-v3/include/bits/locale_facets.tcc
libstdc++-v3/include/bits/locale_facets_nonio.h
libstdc++-v3/include/bits/locale_facets_nonio.tcc
libstdc++-v3/include/bits/localefwd.h
libstdc++-v3/include/bits/mask_array.h
libstdc++-v3/include/bits/move.h
libstdc++-v3/include/bits/ostream.tcc
libstdc++-v3/include/bits/ostream_insert.h
libstdc++-v3/include/bits/postypes.h
libstdc++-v3/include/bits/random.h
libstdc++-v3/include/bits/random.tcc
libstdc++-v3/include/bits/range_access.h
libstdc++-v3/include/bits/regex.h
libstdc++-v3/include/bits/regex_compiler.h
libstdc++-v3/include/bits/regex_constants.h
libstdc++-v3/include/bits/regex_cursor.h
libstdc++-v3/include/bits/regex_error.h
libstdc++-v3/include/bits/regex_grep_matcher.h
libstdc++-v3/include/bits/regex_grep_matcher.tcc
libstdc++-v3/include/bits/regex_nfa.h
libstdc++-v3/include/bits/regex_nfa.tcc
libstdc++-v3/include/bits/shared_ptr.h
libstdc++-v3/include/bits/shared_ptr_base.h
libstdc++-v3/include/bits/slice_array.h
libstdc++-v3/include/bits/sstream.tcc
libstdc++-v3/include/bits/stl_algo.h
libstdc++-v3/include/bits/stl_algobase.h
libstdc++-v3/include/bits/stl_bvector.h
libstdc++-v3/include/bits/stl_construct.h
libstdc++-v3/include/bits/stl_deque.h
libstdc++-v3/include/bits/stl_function.h
libstdc++-v3/include/bits/stl_heap.h
libstdc++-v3/include/bits/stl_iterator.h
libstdc++-v3/include/bits/stl_iterator_base_funcs.h
libstdc++-v3/include/bits/stl_iterator_base_types.h
libstdc++-v3/include/bits/stl_list.h
libstdc++-v3/include/bits/stl_map.h
libstdc++-v3/include/bits/stl_multimap.h
libstdc++-v3/include/bits/stl_multiset.h
libstdc++-v3/include/bits/stl_numeric.h
libstdc++-v3/include/bits/stl_pair.h
libstdc++-v3/include/bits/stl_queue.h
libstdc++-v3/include/bits/stl_raw_storage_iter.h
libstdc++-v3/include/bits/stl_relops.h
libstdc++-v3/include/bits/stl_set.h
libstdc++-v3/include/bits/stl_stack.h
libstdc++-v3/include/bits/stl_tempbuf.h
libstdc++-v3/include/bits/stl_tree.h
libstdc++-v3/include/bits/stl_uninitialized.h
libstdc++-v3/include/bits/stl_vector.h
libstdc++-v3/include/bits/stream_iterator.h
libstdc++-v3/include/bits/streambuf.tcc
libstdc++-v3/include/bits/streambuf_iterator.h
libstdc++-v3/include/bits/stringfwd.h
libstdc++-v3/include/bits/unique_ptr.h
libstdc++-v3/include/bits/unordered_map.h
libstdc++-v3/include/bits/unordered_set.h
libstdc++-v3/include/bits/valarray_after.h
libstdc++-v3/include/bits/valarray_array.h
libstdc++-v3/include/bits/valarray_array.tcc
libstdc++-v3/include/bits/valarray_before.h
libstdc++-v3/include/bits/vector.tcc
libstdc++-v3/include/decimal/decimal
libstdc++-v3/include/ext/atomicity.h
libstdc++-v3/include/ext/cast.h
libstdc++-v3/include/ext/concurrence.h
libstdc++-v3/include/ext/debug_allocator.h
libstdc++-v3/include/ext/extptr_allocator.h
libstdc++-v3/include/ext/pointer.h
libstdc++-v3/include/ext/rc_string_base.h
libstdc++-v3/include/ext/ropeimpl.h
libstdc++-v3/include/ext/sso_string_base.h
libstdc++-v3/include/ext/string_conversions.h
libstdc++-v3/include/ext/typelist.h
libstdc++-v3/include/ext/vstring.tcc
libstdc++-v3/include/ext/vstring_fwd.h
libstdc++-v3/include/ext/vstring_util.h
libstdc++-v3/include/std/atomic
libstdc++-v3/include/std/condition_variable
libstdc++-v3/include/std/fstream
libstdc++-v3/include/std/future
libstdc++-v3/include/std/iomanip
libstdc++-v3/include/std/ios
libstdc++-v3/include/std/iosfwd
libstdc++-v3/include/std/iostream
libstdc++-v3/include/std/istream
libstdc++-v3/include/std/limits
libstdc++-v3/include/std/locale
libstdc++-v3/include/std/mutex
libstdc++-v3/include/std/ostream
libstdc++-v3/include/std/ratio
libstdc++-v3/include/std/sstream
libstdc++-v3/include/std/stdexcept
libstdc++-v3/include/std/streambuf
libstdc++-v3/include/std/system_error
libstdc++-v3/include/std/thread
libstdc++-v3/include/std/valarray
libstdc++-v3/include/tr1/bessel_function.tcc
libstdc++-v3/include/tr1/beta_function.tcc
libstdc++-v3/include/tr1/ell_integral.tcc
libstdc++-v3/include/tr1/exp_integral.tcc
libstdc++-v3/include/tr1/functional_hash.h
libstdc++-v3/include/tr1/gamma.tcc
libstdc++-v3/include/tr1/hashtable.h
libstdc++-v3/include/tr1/hashtable_policy.h
libstdc++-v3/include/tr1/hypergeometric.tcc
libstdc++-v3/include/tr1/legendre_function.tcc
libstdc++-v3/include/tr1/modified_bessel_func.tcc
libstdc++-v3/include/tr1/poly_hermite.tcc
libstdc++-v3/include/tr1/poly_laguerre.tcc
libstdc++-v3/include/tr1/random.h
libstdc++-v3/include/tr1/random.tcc
libstdc++-v3/include/tr1/riemann_zeta.tcc
libstdc++-v3/include/tr1/shared_ptr.h
libstdc++-v3/include/tr1/special_function_util.h
libstdc++-v3/include/tr1/unordered_map.h
libstdc++-v3/include/tr1/unordered_set.h
libstdc++-v3/libsupc++/exception_ptr.h
libstdc++-v3/libsupc++/nested_exception.h
libstdc++-v3/scripts/run_doxygen
libstdc++-v3/testsuite/18_support/headers/cstdbool/std_c++0x_neg.cc
libstdc++-v3/testsuite/18_support/headers/cstdint/std_c++0x_neg.cc
libstdc++-v3/testsuite/19_diagnostics/headers/system_error/std_c++0x_neg.cc
libstdc++-v3/testsuite/20_util/headers/type_traits/std_c++0x_neg.cc
libstdc++-v3/testsuite/23_containers/forward_list/requirements/dr438/assign_neg.cc
libstdc++-v3/testsuite/23_containers/forward_list/requirements/dr438/constructor_1_neg.cc
libstdc++-v3/testsuite/23_containers/forward_list/requirements/dr438/constructor_2_neg.cc
libstdc++-v3/testsuite/23_containers/forward_list/requirements/dr438/insert_neg.cc
libstdc++-v3/testsuite/23_containers/headers/array/std_c++0x_neg.cc
libstdc++-v3/testsuite/23_containers/headers/tuple/std_c++0x_neg.cc
libstdc++-v3/testsuite/23_containers/headers/unordered_map/std_c++0x_neg.cc
libstdc++-v3/testsuite/23_containers/headers/unordered_set/std_c++0x_neg.cc
libstdc++-v3/testsuite/26_numerics/headers/ccomplex/std_c++0x_neg.cc
libstdc++-v3/testsuite/26_numerics/headers/cfenv/std_c++0x_neg.cc
libstdc++-v3/testsuite/26_numerics/headers/ctgmath/std_c++0x_neg.cc
libstdc++-v3/testsuite/26_numerics/headers/random/std_c++0x_neg.cc
libstdc++-v3/testsuite/27_io/headers/cinttypes/std_c++0x_neg.cc
libstdc++-v3/testsuite/28_regex/headers/regex/std_c++0x_neg.cc
libstdc++-v3/testsuite/29_atomics/headers/atomic/std_c++0x_neg.cc
libstdc++-v3/testsuite/30_threads/headers/condition_variable/std_c++0x_neg.cc
libstdc++-v3/testsuite/30_threads/headers/future/std_c++0x_neg.cc
libstdc++-v3/testsuite/30_threads/headers/mutex/std_c++0x_neg.cc
libstdc++-v3/testsuite/30_threads/headers/thread/std_c++0x_neg.cc

index e47576f..251acba 100644 (file)
@@ -1,3 +1,15 @@
+2010-11-18  Benjamin Kosnik  <bkoz@redhat.com>
+
+       * config/*/*: Use headername alias to associate private includes
+       to public includes.
+       * include/*/*: Same.
+
+       * scripts/run_doxygen: Update for doxygen 1.7.2.
+       * doc/doxygen/user.cfg.in: Same.
+       * doc/doxygen/TODO: Remove.
+
+       * testsuite/*/std_c++0x_neg.cc: Adjust line number.
+
 2010-12-17  Paolo Carlini  <paolo.carlini@oracle.com>
 
        * include/bits/basic_string.h (operator+(basic_string<>&&,
index dd54061..f482d20 100644 (file)
@@ -22,9 +22,9 @@
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file c++allocator.h
+/** @file bits/c++allocator.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{memory}
  */
 
 #ifndef _GLIBCXX_CXX_ALLOCATOR_H
index 8e4ce5f..56a6f45 100644 (file)
@@ -22,9 +22,9 @@
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file c++allocator.h
+/** @file bits/c++allocator.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{memory}
  */
 
 #ifndef _GLIBCXX_CXX_ALLOCATOR_H
index 2d2f0ba..135bfac 100644 (file)
@@ -22,9 +22,9 @@
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file c++allocator.h
+/** @file bits/c++allocator.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{memory}
  */
 
 #ifndef _GLIBCXX_CXX_ALLOCATOR_H
index c33a124..8da6d11 100644 (file)
@@ -22,9 +22,9 @@
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file c++allocator.h
+/** @file bits/c++allocator.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{memory}
  */
 
 #ifndef _GLIBCXX_CXX_ALLOCATOR_H
index 703871d..91e0b98 100644 (file)
@@ -22,9 +22,9 @@
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file c++allocator.h
+/** @file bits/c++allocator.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{memory}
  */
 
 #ifndef _GLIBCXX_CXX_ALLOCATOR_H
index ae69ecc..78b0c15 100644 (file)
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file ext/atomicity.h
- *  This file is a GNU extension to the Standard C++ Library.
- */
-
 #include <bits/c++config.h>
 #include <bits/atomic_word.h>
 
index fe3ade8..3f08ebb 100644 (file)
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file ext/atomicity.h
- *  This file is a GNU extension to the Standard C++ Library.
- */
-
 #include <ext/atomicity.h>
 #include <ext/concurrence.h>
 
index faf97e1..a71a2fb 100644 (file)
@@ -22,9 +22,9 @@
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file cpu_defines.h
+/** @file bits/cpu_defines.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{iosfwd}
  */
 
 #ifndef _GLIBCXX_CPU_DEFINES
index 452e6d8..320e980 100644 (file)
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
+/** @file bits/cpu_defines.h
+ *  This is an internal header file, included by other library headers.
+ *  Do not attempt to use it directly. @headername{iosfwd}
+ */
+
 #ifndef _GLIBCXX_CPU_DEFINES
 #define _GLIBCXX_CPU_DEFINES 1
 
index 10b3a3d..dded89f 100644 (file)
@@ -22,9 +22,9 @@
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file cpu_defines.h
+/** @file bits/cpu_defines.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{iosfwd}
  */
 
 #ifndef _GLIBCXX_CPU_DEFINES
index 7f30c4e..a639507 100644 (file)
@@ -27,9 +27,9 @@
 // ISO C++ 14882: 27.8  File-based streams
 //
 
-/** @file basic_file.h
+/** @file bits/basic_file.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{ios}
  */
 
 #ifndef _GLIBCXX_BASIC_FILE_STDIO_H
index f6eeadc..6a21a88 100644 (file)
@@ -23,9 +23,9 @@
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file c++io.h
+/** @file bits/c++io.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{ios}
  */
 
 // c_io_stdio.h - Defines for using "C" stdio.h
index 7d685b8..29c16a2 100644 (file)
@@ -23,9 +23,9 @@
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file c++locale.h
+/** @file bits/c++locale.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{locale}
  */
 
 //
index a149950..c6e1afd 100644 (file)
@@ -23,9 +23,9 @@
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file messages_members.h
+/** @file bits/messages_members.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{locale}
  */
 
 //
index 394989e..785a272 100644 (file)
@@ -24,9 +24,9 @@
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file time_members.h
+/** @file bits/time_members.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{locale}
  */
 
 //
index 03d3d62..85d0022 100644 (file)
@@ -23,9 +23,9 @@
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file c++locale_internal.h
+/** @file bits/c++locale_internal.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{locale}
  */
 
 // Written by Jakub Jelinek <jakub@redhat.com>
index 1809119..f3aa2e3 100644 (file)
@@ -23,9 +23,9 @@
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file c++locale.h
+/** @file bits/c++locale.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{locale}
  */
 
 //
index b633efa..836f76a 100644 (file)
@@ -23,9 +23,9 @@
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file messages_members.h
+/** @file bits/messages_members.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{locale}
  */
 
 //
index 5b81d9c..7d3ddc2 100644 (file)
@@ -24,9 +24,9 @@
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file time_members.h
+/** @file bits/time_members.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{locale}
  */
 
 //
index 8bac8d3..21a023f 100644 (file)
@@ -22,9 +22,9 @@
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file c++locale.h
+/** @file bits/c++locale.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{locale}
  */
 
 //
index efc6be3..8612984 100644 (file)
@@ -22,9 +22,9 @@
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file messages_members.h
+/** @file bits/messages_members.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{locale}
  */
 
 //
index bc3aafd..0715f14 100644 (file)
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
+/** @file bits/atomic_word.h
+ *  This is an internal header file, included by other library headers.
+ *  Do not attempt to use it directly. @headername{ext/atomicity.h}
+ */
+
 #ifndef _GLIBCXX_ATOMIC_WORD_H
 #define _GLIBCXX_ATOMIC_WORD_H 1
 
@@ -33,6 +38,6 @@ typedef int _Atomic_word;
 #else
 #define _GLIBCXX_READ_MEM_BARRIER __asm __volatile ("":::"memory")
 #define _GLIBCXX_WRITE_MEM_BARRIER __asm __volatile ("":::"memory")
-#endif 
+#endif
 
 #endif
index 976025c..435f9cf 100644 (file)
 // a copy of the GCC Runtime Library Exception along with this program;
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
-  
-/** @file ctype_inline.h
+
+/** @file bits/ctype_inline.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{locale}
  */
 
 //
 
 // ctype bits to be inlined go here. Non-inlinable (ie virtual do_*)
 // functions go in ctype.cc
-  
+
 _GLIBCXX_BEGIN_NAMESPACE(std)
 
   bool
   ctype<char>::
-  is(mask __m, char __c) const 
+  is(mask __m, char __c) const
   { return __OBJ_DATA(__lc_ctype)->mask[__c] & __m; }
 
   const char*
   ctype<char>::
-  is(const char* __low, const char* __high, mask* __vec) const 
+  is(const char* __low, const char* __high, mask* __vec) const
   {
     while (__low < __high)
       *__vec++ = __OBJ_DATA(__lc_ctype)->mask[*__low++];
@@ -52,7 +52,7 @@ _GLIBCXX_BEGIN_NAMESPACE(std)
 
   const char*
   ctype<char>::
-  scan_is(mask __m, const char* __low, const char* __high) const 
+  scan_is(mask __m, const char* __low, const char* __high) const
   {
     while (__low < __high && !this->is(__m, *__low))
       ++__low;
@@ -61,7 +61,7 @@ _GLIBCXX_BEGIN_NAMESPACE(std)
 
   const char*
   ctype<char>::
-  scan_not(mask __m, const char* __low, const char* __high) const 
+  scan_not(mask __m, const char* __low, const char* __high) const
   {
     while (__low < __high && this->is(__m, *__low) != 0)
       ++__low;
index 6349167..606b372 100644 (file)
@@ -22,9 +22,9 @@
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file ctype_noninline.h
+/** @file bits/ctype_noninline.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{locale}
  */
 
 //
@@ -42,7 +42,7 @@
   : facet(__refs), _M_del(__table != 0 && __del),
   _M_toupper(NULL), _M_tolower(NULL),
   _M_table(__table ? __table : classic_table())
-  { 
+  {
     memset(_M_widen, 0, sizeof(_M_widen));
     _M_widen_ok = 0;
     memset(_M_narrow, 0, sizeof(_M_narrow));
@@ -53,7 +53,7 @@
   : facet(__refs), _M_del(__table != 0 && __del),
   _M_toupper(NULL), _M_tolower(NULL),
   _M_table(__table ? __table : classic_table())
-  { 
+  {
     memset(_M_widen, 0, sizeof(_M_widen));
     _M_widen_ok = 0;
     memset(_M_narrow, 0, sizeof(_M_narrow));
@@ -89,4 +89,3 @@
       }
     return __high;
   }
-
index 642afa8..6b06bd1 100644 (file)
@@ -22,9 +22,9 @@
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file os_defines.h
+/** @file bits/os_defines.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{iosfwd}
  */
 
 #ifndef _GLIBCXX_OS_DEFINES
index 2c88eb6..ef12c65 100644 (file)
@@ -22,9 +22,9 @@
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file ctype_inline.h
+/** @file bits/ctype_inline.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{locale}
  */
 
 //
index 55eecd8..78bc296 100644 (file)
@@ -22,9 +22,9 @@
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file ctype_noninline.h
+/** @file bits/ctype_noninline.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{locale}
  */
 
 //
index 832592a..0c8f77d 100644 (file)
@@ -22,9 +22,9 @@
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file os_defines.h
+/** @file bits/os_defines.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{iosfwd}
  */
 
 #ifndef _GLIBCXX_OS_DEFINES
index 4b79a44..91e25b2 100644 (file)
@@ -22,9 +22,9 @@
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file ctype_inline.h
+/** @file bits/ctype_inline.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{locale}
  */
 
 //
index ea524e5..07fe71d 100644 (file)
@@ -22,9 +22,9 @@
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file ctype_noninline.h
+/** @file bits/ctype_noninline.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{locale}
  */
 
 //
index e358887..2063673 100644 (file)
 //
 // ISO C++ 14882: 22.1  Locales
 //
-  
+
 // Information as gleaned from /usr/include/ctype.h on FreeBSD 3.4,
 // 4.0 and all versions of the CVS managed file at:
 // :pserver:anoncvs@anoncvs.freebsd.org:/home/ncvs/src/include/ctype.h
-  
+
 _GLIBCXX_BEGIN_NAMESPACE(std)
 
   /// @brief  Base class for ctype.
index 27d47d1..6a7b542 100644 (file)
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file ctype_inline.h
+/** @file bits/ctype_inline.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{locale}
  */
 
 //
 // ISO C++ 14882: 22.1  Locales
 //
-  
+
 // ctype bits to be inlined go here. Non-inlinable (ie virtual do_*)
 // functions go in ctype.cc
-  
+
 _GLIBCXX_BEGIN_NAMESPACE(std)
 
   bool
   ctype<char>::
   is(mask __m, char __c) const
-  { 
+  {
     if (_M_table)
       return _M_table[static_cast<unsigned char>(__c)] & __m;
     else
@@ -107,7 +107,7 @@ _GLIBCXX_BEGIN_NAMESPACE(std)
     return __low;
   }
 
-#ifdef _GLIBCXX_USE_WCHAR_T  
+#ifdef _GLIBCXX_USE_WCHAR_T
   inline bool
   ctype<wchar_t>::
   do_is(mask __m, wchar_t __c) const
@@ -115,7 +115,7 @@ _GLIBCXX_BEGIN_NAMESPACE(std)
     return __istype (__c, __m);
   }
 
-  inline const wchar_t* 
+  inline const wchar_t*
   ctype<wchar_t>::
   do_is(const wchar_t* __lo, const wchar_t* __hi, mask* __vec) const
   {
@@ -124,8 +124,8 @@ _GLIBCXX_BEGIN_NAMESPACE(std)
                           | space | print | graph | cntrl | punct | alnum);
     return __hi;
   }
-  
-  inline const wchar_t* 
+
+  inline const wchar_t*
   ctype<wchar_t>::
   do_scan_is(mask __m, const wchar_t* __lo, const wchar_t* __hi) const
   {
index ea524e5..07fe71d 100644 (file)
@@ -22,9 +22,9 @@
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file ctype_noninline.h
+/** @file bits/ctype_noninline.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{locale}
  */
 
 //
index 5849f44..343560c 100644 (file)
@@ -22,9 +22,9 @@
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file ctype_inline.h
+/** @file bits/ctype_inline.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{locale}
  */
 
 //
index f971ab0..efdb26c 100644 (file)
@@ -22,9 +22,9 @@
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file ctype_noninline.h
+/** @file bits/ctype_noninline.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{locale}
  */
 
 //
index e8dacbc..399c64c 100644 (file)
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file ctype_inline.h
+/** @file bits/ctype_inline.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{locale}
  */
 
 //
 // ISO C++ 14882: 22.1  Locales
 //
-  
+
 // ctype bits to be inlined go here. Non-inlinable (ie virtual do_*)
 // functions go in ctype.cc
-  
+
 _GLIBCXX_BEGIN_NAMESPACE(std)
 
   bool
   ctype<char>::
-  is(mask __m, char __c) const 
+  is(mask __m, char __c) const
   { return _M_table[static_cast<unsigned char>(__c)] & __m; }
 
   const char*
   ctype<char>::
-  is(const char* __low, const char* __high, mask* __vec) const 
+  is(const char* __low, const char* __high, mask* __vec) const
   {
     while (__low < __high)
       *__vec++ = _M_table[static_cast<unsigned char>(*__low++)];
@@ -54,7 +54,7 @@ _GLIBCXX_BEGIN_NAMESPACE(std)
   ctype<char>::
   scan_is(mask __m, const char* __low, const char* __high) const
   {
-    while (__low < __high 
+    while (__low < __high
           && !(_M_table[static_cast<unsigned char>(*__low)] & __m))
       ++__low;
     return __low;
@@ -64,7 +64,7 @@ _GLIBCXX_BEGIN_NAMESPACE(std)
   ctype<char>::
   scan_not(mask __m, const char* __low, const char* __high) const
   {
-    while (__low < __high 
+    while (__low < __high
           && (_M_table[static_cast<unsigned char>(*__low)] & __m) != 0)
       ++__low;
     return __low;
index e9005ee..8f359db 100644 (file)
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file ctype_noninline.h
+/** @file bits/ctype_noninline.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{locale}
  */
 
 //
 // ISO C++ 14882: 22.1  Locales
 //
-  
+
 // Information as gleaned from DJGPP <ctype.h>
 
   const ctype_base::mask*
   ctype<char>::classic_table() throw()
   { return __dj_ctype_flags+1; }
 
-  ctype<char>::ctype(__c_locale, const mask* __table, bool __del, 
-                    size_t __refs) 
-  : facet(__refs), _M_del(__table != 0 && __del), 
+  ctype<char>::ctype(__c_locale, const mask* __table, bool __del,
+                    size_t __refs)
+  : facet(__refs), _M_del(__table != 0 && __del),
   _M_toupper(__dj_ctype_toupper), _M_tolower(__dj_ctype_tolower),
-  _M_table(__table ? __table : classic_table()) 
-  { 
+  _M_table(__table ? __table : classic_table())
+  {
     memset(_M_widen, 0, sizeof(_M_widen));
     _M_widen_ok = 0;
     memset(_M_narrow, 0, sizeof(_M_narrow));
     _M_narrow_ok = 0;
   }
 
-  ctype<char>::ctype(const mask* __table, bool __del, size_t __refs) 
-  : facet(__refs), _M_del(__table != 0 && __del), 
+  ctype<char>::ctype(const mask* __table, bool __del, size_t __refs)
+  : facet(__refs), _M_del(__table != 0 && __del),
   _M_toupper(__dj_ctype_toupper), _M_tolower(__dj_ctype_tolower),
-  _M_table(__table ? __table : classic_table()) 
-  { 
+  _M_table(__table ? __table : classic_table())
+  {
     memset(_M_widen, 0, sizeof(_M_widen));
     _M_widen_ok = 0;
     memset(_M_narrow, 0, sizeof(_M_narrow));
@@ -79,7 +79,7 @@
   ctype<char>::do_tolower(char __c) const
   { return _M_tolower[static_cast<unsigned char>(__c)]; }
 
-  const char* 
+  const char*
   ctype<char>::do_tolower(char* __low, const char* __high) const
   {
     while (__low < __high)
index 3efe540..d359018 100644 (file)
@@ -22,9 +22,9 @@
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file error_constants.h
+/** @file bits/error_constants.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{system_error}
  */
 
 #ifndef _GLIBCXX_ERROR_CONSTANTS
index 28c3fdc..dba8e45 100644 (file)
@@ -22,9 +22,9 @@
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file os_defines.h
+/** @file bits/os_defines.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{iosfwd}
  */
 
 #ifndef _GLIBCXX_OS_DEFINES
index 2597a0c..34acea5 100644 (file)
@@ -25,9 +25,9 @@
 //
 // ISO C++ 14882: 22.1  Locales
 //
-  
+
 // Default information, may not be appropriate for specific host.
-  
+
 _GLIBCXX_BEGIN_NAMESPACE(std)
 
   /// @brief  Base class for ctype.
@@ -38,7 +38,7 @@ _GLIBCXX_BEGIN_NAMESPACE(std)
 
     // NB: Offsets into ctype<char>::_M_table force a particular size
     // on the mask type. Because of this, we don't use an enum.
-    typedef unsigned int       mask;   
+    typedef unsigned int       mask;
     static const mask upper            = 1 << 0;
     static const mask lower    = 1 << 1;
     static const mask alpha    = 1 << 2;
@@ -46,7 +46,7 @@ _GLIBCXX_BEGIN_NAMESPACE(std)
     static const mask xdigit   = 1 << 4;
     static const mask space    = 1 << 5;
     static const mask print    = 1 << 6;
-    static const mask graph    = (1 << 2) | (1 << 3) | (1 << 9);  // alnum|punct
+    static const mask graph    = (1 << 2) | (1 << 3) | (1 << 9); // alnum|punct
     static const mask cntrl    = 1 << 8;
     static const mask punct    = 1 << 9;
     static const mask alnum    = (1 << 2) | (1 << 3);  // alpha|digit
index 7ebc8b4..219620a 100644 (file)
@@ -22,9 +22,9 @@
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file ctype_inline.h
+/** @file bits/ctype_inline.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{locale}
  */
 
 //
index a0beaf0..2bb47ce 100644 (file)
@@ -23,9 +23,9 @@
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file ctype_noninline.h
+/** @file bits/ctype_noninline.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{locale}
  */
 
 //
index 61c0349..311bbf2 100644 (file)
@@ -22,9 +22,9 @@
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file error_constants.h
+/** @file bits/error_constants.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{system_error}
  */
 
 #ifndef _GLIBCXX_ERROR_CONSTANTS
index ecf9aa3..61eb923 100644 (file)
@@ -22,9 +22,9 @@
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file os_defines.h
+/** @file bits/os_defines.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{iosfwd}
  */
 
 #ifndef _GLIBCXX_OS_DEFINES
index ff1f157..2baed6a 100644 (file)
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
+/** @file bits/ctype_base.h
+ *  This is an internal header file, included by other library headers.
+ *  Do not attempt to use it directly. @headername{locale}
+ */
+
 //
 // ISO C++ 14882: 22.1  Locales
 //
-  
-/** @file ctype_base.h
- *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
- */
 
 // Information as gleaned from /usr/include/ctype.h
-  
+
 _GLIBCXX_BEGIN_NAMESPACE(std)
 
   /// @brief  Base class for ctype.
@@ -44,7 +44,7 @@ _GLIBCXX_BEGIN_NAMESPACE(std)
 
     // NB: Offsets into ctype<char>::_M_table force a particular size
     // on the mask type. Because of this, we don't use an enum.
-    typedef unsigned short     mask;   
+    typedef unsigned short     mask;
     static const mask upper            = _ISupper;
     static const mask lower    = _ISlower;
     static const mask alpha    = _ISalpha;
index 8ae8229..2fce1fd 100644 (file)
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file ctype_inline.h
+/** @file bits/ctype_inline.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{locale}
  */
 
 //
 // ISO C++ 14882: 22.1  Locales
 //
-  
+
 // ctype bits to be inlined go here. Non-inlinable (ie virtual do_*)
 // functions go in ctype.cc
-  
+
 _GLIBCXX_BEGIN_NAMESPACE(std)
 
   bool
@@ -54,7 +54,7 @@ _GLIBCXX_BEGIN_NAMESPACE(std)
   ctype<char>::
   scan_is(mask __m, const char* __low, const char* __high) const
   {
-    while (__low < __high 
+    while (__low < __high
           && !(_M_table[static_cast<unsigned char>(*__low)] & __m))
       ++__low;
     return __low;
@@ -64,7 +64,7 @@ _GLIBCXX_BEGIN_NAMESPACE(std)
   ctype<char>::
   scan_not(mask __m, const char* __low, const char* __high) const
   {
-    while (__low < __high 
+    while (__low < __high
           && (_M_table[static_cast<unsigned char>(*__low)] & __m) != 0)
       ++__low;
     return __low;
index 4fc47a9..492a731 100644 (file)
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file ctype_noninline.h
+/** @file bits/ctype_noninline.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{locale}
  */
 
 //
 // ISO C++ 14882: 22.1  Locales
 //
-  
+
 // Information as gleaned from /usr/include/ctype.h
 
 #if _GLIBCXX_C_LOCALE_GNU
 #endif
 
 #if _GLIBCXX_C_LOCALE_GNU
-  ctype<char>::ctype(__c_locale __cloc, const mask* __table, bool __del, 
-                    size_t __refs) 
-  : facet(__refs), _M_c_locale_ctype(_S_clone_c_locale(__cloc)), 
-  _M_del(__table != 0 && __del), 
-  _M_toupper(_M_c_locale_ctype->__ctype_toupper),  
-  _M_tolower(_M_c_locale_ctype->__ctype_tolower), 
-  _M_table(__table ? __table : _M_c_locale_ctype->__ctype_b), 
-  _M_widen_ok(0), _M_narrow_ok(0) 
+  ctype<char>::ctype(__c_locale __cloc, const mask* __table, bool __del,
+                    size_t __refs)
+  : facet(__refs), _M_c_locale_ctype(_S_clone_c_locale(__cloc)),
+  _M_del(__table != 0 && __del),
+  _M_toupper(_M_c_locale_ctype->__ctype_toupper),
+  _M_tolower(_M_c_locale_ctype->__ctype_tolower),
+  _M_table(__table ? __table : _M_c_locale_ctype->__ctype_b),
+  _M_widen_ok(0), _M_narrow_ok(0)
   {
     __builtin_memset(_M_widen, 0, sizeof(_M_widen));
     __builtin_memset(_M_narrow, 0, sizeof(_M_narrow));
   }
 #else
-  ctype<char>::ctype(__c_locale, const mask* __table, bool __del, 
-                    size_t __refs) 
-  : facet(__refs), _M_c_locale_ctype(_S_get_c_locale()), 
+  ctype<char>::ctype(__c_locale, const mask* __table, bool __del,
+                    size_t __refs)
+  : facet(__refs), _M_c_locale_ctype(_S_get_c_locale()),
   _M_del(__table != 0 && __del), _M_widen_ok(0), _M_narrow_ok(0)
   {
     char* __old = setlocale(LC_CTYPE, NULL);
     char* __sav = NULL;
     if (__builtin_strcmp(__old, "C"))
-      {    
+      {
        const size_t __len = __builtin_strlen(__old) + 1;
        __sav = new char[__len];
-       __builtin_memcpy(__sav, __old, __len);    
+       __builtin_memcpy(__sav, __old, __len);
        setlocale(LC_CTYPE, "C");
       }
 #if __GLIBC__ > 2 || (__GLIBC__ == 2 && __GLIBC_MINOR__ > 2)
 #endif
 
 #if _GLIBCXX_C_LOCALE_GNU
-  ctype<char>::ctype(const mask* __table, bool __del, size_t __refs) 
-  : facet(__refs), _M_c_locale_ctype(_S_get_c_locale()), 
+  ctype<char>::ctype(const mask* __table, bool __del, size_t __refs)
+  : facet(__refs), _M_c_locale_ctype(_S_get_c_locale()),
   _M_del(__table != 0 && __del),
-  _M_toupper(_M_c_locale_ctype->__ctype_toupper),  
-  _M_tolower(_M_c_locale_ctype->__ctype_tolower), 
-  _M_table(__table ? __table : _M_c_locale_ctype->__ctype_b), 
-  _M_widen_ok(0), _M_narrow_ok(0) 
+  _M_toupper(_M_c_locale_ctype->__ctype_toupper),
+  _M_tolower(_M_c_locale_ctype->__ctype_tolower),
+  _M_table(__table ? __table : _M_c_locale_ctype->__ctype_b),
+  _M_widen_ok(0), _M_narrow_ok(0)
   {
     __builtin_memset(_M_widen, 0, sizeof(_M_widen));
     __builtin_memset(_M_narrow, 0, sizeof(_M_narrow));
   }
 #else
   ctype<char>::ctype(const mask* __table, bool __del, size_t __refs)
-  : facet(__refs), _M_c_locale_ctype(_S_get_c_locale()), 
+  : facet(__refs), _M_c_locale_ctype(_S_get_c_locale()),
   _M_del(__table != 0 && __del), _M_widen_ok(0), _M_narrow_ok(0)
   {
     char* __old = setlocale(LC_CTYPE, NULL);
   ctype<char>::do_tolower(char __c) const
   { return _M_tolower[static_cast<unsigned char>(__c)]; }
 
-  const char* 
+  const char*
   ctype<char>::do_tolower(char* __low, const char* __high) const
   {
     while (__low < __high)
index 9c42b3a..922e2e9 100644 (file)
@@ -22,9 +22,9 @@
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file os_defines.h
+/** @file bits/os_defines.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{iosfwd}
  */
 
 #ifndef _GLIBCXX_OS_DEFINES
index 564d6d2..a4fd531 100644 (file)
@@ -22,9 +22,9 @@
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
   
-/** @file ctype_inline.h
+/** @file bits/ctype_inline.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{locale}
  */
 
 //
index 37e2e7b..3bd7de3 100644 (file)
@@ -23,9 +23,9 @@
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file ctype_noninline.h
+/** @file bits/ctype_noninline.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{locale}
  */
 
 //
index 6edafe2..32dc40b 100644 (file)
@@ -22,9 +22,9 @@
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file os_defines.h
+/** @file bits/os_defines.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{iosfwd}
  */
 
 #ifndef _GLIBCXX_OS_DEFINES
index 677aa79..28f9ed8 100644 (file)
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
+/** @file bits/atomic_word.h
+ *  This is an internal header file, included by other library headers.
+ *  Do not attempt to use it directly. @headername{ext/atomicity.h}
+ */
+
 #ifndef _GLIBCXX_ATOMIC_WORD_H
 #define _GLIBCXX_ATOMIC_WORD_H 1
 
index 4107ad8..e674187 100644 (file)
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
+/** @file bits/ctype_base.h
+ *  This is an internal header file, included by other library headers.
+ *  Do not attempt to use it directly. @headername{locale}
+ */
+
 //
 // ISO C++ 14882: 22.1  Locales
 //
-  
+
 // Information as gleaned from /usr/include/ctype.h on irix 6.5
-  
+
 _GLIBCXX_BEGIN_NAMESPACE(std)
 
   /// @brief  Base class for ctype.
index d99997b..c1df63b 100644 (file)
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file ctype_inline.h
+/** @file bits/ctype_inline.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{locale}
  */
 
 //
 // ISO C++ 14882: 22.1  Locales
 //
-  
+
 // ctype bits to be inlined go here. Non-inlinable (ie virtual do_*)
 // functions go in ctype.cc
-  
+
 _GLIBCXX_BEGIN_NAMESPACE(std)
 
   bool
index a8a1686..c29f765 100644 (file)
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file ctype_noninline.h
+/** @file bits/ctype_noninline.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{locale}
  */
 
 //
 // ISO C++ 14882: 22.1  Locales
 //
-  
+
 // Information as gleaned from /usr/include/ctype.h
 
   const ctype_base::mask*
   ctype<char>::classic_table() throw()
   { return 0; }
 
-  ctype<char>::ctype(__c_locale, const mask* __table, bool __del, 
+  ctype<char>::ctype(__c_locale, const mask* __table, bool __del,
                     size_t __refs)
-  : facet(__refs), _M_del(__table != 0 && __del), 
-  _M_toupper(NULL), _M_tolower(NULL), 
-  _M_table(!__table ? 
-          (const mask*) (__libc_attr._ctype_tbl->_class + 1) : __table) 
-  { 
+  : facet(__refs), _M_del(__table != 0 && __del),
+  _M_toupper(NULL), _M_tolower(NULL),
+  _M_table(!__table ?
+          (const mask*) (__libc_attr._ctype_tbl->_class + 1) : __table)
+  {
     memset(_M_widen, 0, sizeof(_M_widen));
     _M_widen_ok = 0;
     memset(_M_narrow, 0, sizeof(_M_narrow));
   }
 
   ctype<char>::ctype(const mask* __table, bool __del, size_t __refs)
-  : facet(__refs), _M_del(__table != 0 && __del), 
-  _M_toupper(NULL), _M_tolower(NULL), 
-  _M_table(!__table ? 
-          (const mask*) (__libc_attr._ctype_tbl->_class + 1) : __table) 
-  { 
+  : facet(__refs), _M_del(__table != 0 && __del),
+  _M_toupper(NULL), _M_tolower(NULL),
+  _M_table(!__table ?
+          (const mask*) (__libc_attr._ctype_tbl->_class + 1) : __table)
+  {
     memset(_M_widen, 0, sizeof(_M_widen));
     _M_widen_ok = 0;
     memset(_M_narrow, 0, sizeof(_M_narrow));
@@ -81,7 +81,7 @@
   ctype<char>::do_tolower(char __c) const
   { return _tolower(__c); }
 
-  const char* 
+  const char*
   ctype<char>::do_tolower(char* __low, const char* __high) const
   {
     while (__low < __high)
@@ -91,4 +91,3 @@
       }
     return __high;
   }
-
index 1bfd862..7128190 100644 (file)
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
+/** @file bits/os_defines.h
+ *  This is an internal header file, included by other library headers.
+ *  Do not attempt to use it directly. @headername{iosfwd}
+ */
+
 #ifndef _GLIBCXX_OS_DEFINES
 #define _GLIBCXX_OS_DEFINES 1
 
index ab5a605..3f96b48 100644 (file)
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file ctype_inline.h
+/** @file bits/ctype_inline.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{locale}
  */
 
 //
 // ISO C++ 14882: 22.1  Locales
 //
-  
+
 // ctype bits to be inlined go here. Non-inlinable (ie virtual do_*)
 // functions go in ctype.cc
 
@@ -40,11 +40,11 @@ _GLIBCXX_BEGIN_NAMESPACE(std)
   ctype<char>::
   is(mask __m, char __c) const
   { return (_M_table[static_cast<unsigned char>(__c) ] & __m); }
-   
+
+
   const char*
   ctype<char>::
-  is(const char* __low, const char* __high, mask* __vec) const 
+  is(const char* __low, const char* __high, mask* __vec) const
   {
     while (__low < __high)
       *__vec++ = _M_table[static_cast<unsigned char>(*__low++)];
index 047e52f..968797b 100644 (file)
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file ctype_noninline.h
+/** @file bits/ctype_noninline.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{locale}
  */
 
 //
 // ISO C++ 14882: 22.1  Locales
 //
-  
+
 // The classic table used in libstdc++ is *not* the C _ctype table
 // used by mscvrt, but is based on the ctype masks defined for libstdc++
 // in ctype_base.h.
@@ -39,7 +39,7 @@
   const ctype_base::mask*
   ctype<char>::classic_table() throw()
   {
-    static const ctype_base::mask _S_classic_table[256] = 
+    static const ctype_base::mask _S_classic_table[256] =
     {
       cntrl /* null */,
       cntrl /* ^A */,
     return _S_classic_table;
   }
 
-  ctype<char>::ctype(__c_locale, const mask* __table, bool __del, 
-                    size_t __refs) 
-  : facet(__refs), _M_del(__table != 0 && __del), 
+  ctype<char>::ctype(__c_locale, const mask* __table, bool __del,
+                    size_t __refs)
+  : facet(__refs), _M_del(__table != 0 && __del),
   _M_toupper(NULL), _M_tolower(NULL),
-  _M_table(__table ? __table : classic_table())  
-  { 
+  _M_table(__table ? __table : classic_table())
+  {
     memset(_M_widen, 0, sizeof(_M_widen));
     _M_widen_ok = 0;
     memset(_M_narrow, 0, sizeof(_M_narrow));
     _M_narrow_ok = 0;
   }
 
-  ctype<char>::ctype(const mask* __table, bool __del, size_t __refs) 
-  : facet(__refs), _M_del(__table != 0 && __del), 
+  ctype<char>::ctype(const mask* __table, bool __del, size_t __refs)
+  : facet(__refs), _M_del(__table != 0 && __del),
   _M_toupper(NULL), _M_tolower(NULL),
-  _M_table(__table ? __table : classic_table()) 
-  { 
+  _M_table(__table ? __table : classic_table())
+  {
     memset(_M_widen, 0, sizeof(_M_widen));
     _M_widen_ok = 0;
     memset(_M_narrow, 0, sizeof(_M_narrow));
   ctype<char>::do_tolower(char __c) const
   { return (this->is(ctype_base::upper, __c) ? (__c - 'A' + 'a') : __c); }
 
-  const char* 
+  const char*
   ctype<char>::do_tolower(char* __low, const char* __high) const
   {
     while (__low < __high)
       }
     return __high;
   }
-
-
-
-
index 2fa3877..7c6c59b 100644 (file)
@@ -22,9 +22,9 @@
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file error_constants.h
+/** @file bits/error_constants.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{system_error}
  */
 
 #ifndef _GLIBCXX_ERROR_CONSTANTS
@@ -80,8 +80,8 @@ _GLIBCXX_BEGIN_NAMESPACE(std)
 //    no_child_process =                       ECHILD,
 //    no_link =                                ENOLINK,
       no_lock_available =                      ENOLCK,
-//    no_message_available =                   ENODATA, 
-//    no_message =                             ENOMSG, 
+//    no_message_available =                   ENODATA,
+//    no_message =                             ENOMSG,
 //    no_protocol_option =                     ENOPROTOOPT,
 //    no_space_on_device =                     ENOSPC,
 //    no_stream_resources =                    ENOSR,
index 22a11f5..ac1a90d 100644 (file)
@@ -23,9 +23,9 @@
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file os_defines.h
+/** @file bits/os_defines.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{iosfwd}
  */
 
 #ifndef _GLIBCXX_OS_DEFINES
index ffc61cd..7205309 100644 (file)
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file ctype_inline.h
+/** @file bits/ctype_inline.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{locale}
  */
 
 //
 // ISO C++ 14882: 22.1  Locales
 //
-  
+
 // ctype bits to be inlined go here. Non-inlinable (ie virtual do_*)
 // functions go in ctype.cc
-  
+
 _GLIBCXX_BEGIN_NAMESPACE(std)
 
   bool
@@ -52,7 +52,7 @@ _GLIBCXX_BEGIN_NAMESPACE(std)
 
   const char*
   ctype<char>::
-  scan_is(mask __m, const char* __low, const char* __high) const 
+  scan_is(mask __m, const char* __low, const char* __high) const
   {
     while (__low < __high && !this->is(__m, *__low))
       ++__low;
index 7fc8fbb..c9db357 100644 (file)
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file ctype_noninline.h
+/** @file bits/ctype_noninline.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{locale}
  */
 
 //
 // ISO C++ 14882: 22.1  Locales
 //
-  
+
 // Information as gleaned from /usr/include/ctype.h
-  
+
   const ctype_base::mask*
   ctype<char>::classic_table() throw()
   { return _ctype_ + 1; }
 
-  ctype<char>::ctype(__c_locale, const mask* __table, bool __del, 
-                    size_t __refs) 
-  : facet(__refs), _M_del(__table != 0 && __del), 
-  _M_toupper(NULL), _M_tolower(NULL), 
-  _M_table(__table ? __table : classic_table()) 
-  { 
+  ctype<char>::ctype(__c_locale, const mask* __table, bool __del,
+                    size_t __refs)
+  : facet(__refs), _M_del(__table != 0 && __del),
+  _M_toupper(NULL), _M_tolower(NULL),
+  _M_table(__table ? __table : classic_table())
+  {
     memset(_M_widen, 0, sizeof(_M_widen));
     _M_widen_ok = 0;
     memset(_M_narrow, 0, sizeof(_M_narrow));
     _M_narrow_ok = 0;
   }
 
-  ctype<char>::ctype(const mask* __table, bool __del, size_t __refs) 
-  : facet(__refs), _M_del(__table != 0 && __del), 
-  _M_toupper(NULL), _M_tolower(NULL), 
-  _M_table(__table ? __table : classic_table()) 
-  { 
+  ctype<char>::ctype(const mask* __table, bool __del, size_t __refs)
+  : facet(__refs), _M_del(__table != 0 && __del),
+  _M_toupper(NULL), _M_tolower(NULL),
+  _M_table(__table ? __table : classic_table())
+  {
     memset(_M_widen, 0, sizeof(_M_widen));
     _M_widen_ok = 0;
     memset(_M_narrow, 0, sizeof(_M_narrow));
@@ -62,7 +62,7 @@
 
   char
   ctype<char>::do_toupper(char __c) const
-  { 
+  {
     int __x = __c;
     return (this->is(ctype_base::lower, __c) ? (__x - 'a' + 'A') : __x);
   }
 
   char
   ctype<char>::do_tolower(char __c) const
-  { 
+  {
     int __x = __c;
     return (this->is(ctype_base::upper, __c) ? (__x - 'A' + 'a') : __x);
   }
 
-  const char* 
+  const char*
   ctype<char>::do_tolower(char* __low, const char* __high) const
   {
     while (__low < __high)
@@ -95,4 +95,3 @@
       }
     return __high;
   }
-
index 1ff3d48..3094cc6 100644 (file)
@@ -22,9 +22,9 @@
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file os_defines.h
+/** @file bits/os_defines.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{iosfwd}
  */
 
 #ifndef _GLIBCXX_OS_DEFINES
index 43f6ffa..620db3a 100644 (file)
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
+/** @file bits/ctype_base.h
+ *  This is an internal header file, included by other library headers.
+ *  Do not attempt to use it directly. @headername{locale}
+ */
+
 //
 // ISO C++ 14882: 22.1  Locales
 //
-  
+
 // Information as gleaned from /usr/include/ctype.h.
-  
+
 _GLIBCXX_BEGIN_NAMESPACE(std)
 
   /// @brief  Base class for ctype.
index 7013480..2baa166 100644 (file)
@@ -22,9 +22,9 @@
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file ctype_inline.h
+/** @file bits/ctype_inline.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{locale}
  */
 
 //
index 7956c9b..08f0f3e 100644 (file)
@@ -22,9 +22,9 @@
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file ctype_noninline.h
+/** @file bits/ctype_noninline.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{locale}
  */
 
 //
index 564d6d2..a4fd531 100644 (file)
@@ -22,9 +22,9 @@
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
   
-/** @file ctype_inline.h
+/** @file bits/ctype_inline.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{locale}
  */
 
 //
index ff5d9d8..42f7c1e 100644 (file)
@@ -23,9 +23,9 @@
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file ctype_noninline.h
+/** @file bits/ctype_noninline.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{locale}
  */
 
 //
index c2a1bff..deea52a 100644 (file)
@@ -22,9 +22,9 @@
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file ctype_inline.h
+/** @file bits/ctype_inline.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{locale}
  */
 
 //
index 64917c4..4fc340c 100644 (file)
@@ -22,9 +22,9 @@
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file ctype_noninline.h
+/** @file bits/ctype_noninline.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{locale}
  */
 
 //
index 0154a29..56e0be9 100644 (file)
@@ -22,9 +22,9 @@
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file os_defines.h
+/** @file bits/os_defines.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{iosfwd}
  */
 
 #ifndef _GLIBCXX_OS_DEFINES
index 7549c73..d60d119 100644 (file)
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
+/** @file bits/ctype_base.h
+ *  This is an internal header file, included by other library headers.
+ *  Do not attempt to use it directly. @headername{locale}
+ */
+
 //
 // ISO C++ 14882: 22.1  Locales
 //
-  
-/** @file ctype_base.h
- *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
- */
 
 // Information as gleaned from /usr/include/ctype.h
-  
+
 _GLIBCXX_BEGIN_NAMESPACE(std)
 
   /// @brief  Base class for ctype.
   struct ctype_base
   {
     // Note: In uClibc, the following two types depend on configuration.
+
     // Non-standard typedefs.
     typedef const __ctype_touplow_t* __to_type;
 
     // NB: Offsets into ctype<char>::_M_table force a particular size
     // on the mask type. Because of this, we don't use an enum.
-    typedef __ctype_mask_t     mask;   
+    typedef __ctype_mask_t     mask;
     static const mask upper            = _ISupper;
     static const mask lower    = _ISlower;
     static const mask alpha    = _ISalpha;
index 1309416..2edeae5 100644 (file)
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file ctype_inline.h
+/** @file bits/ctype_inline.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{locale}
  */
 
 //
 // ISO C++ 14882: 22.1  Locales
 //
-  
+
 // ctype bits to be inlined go here. Non-inlinable (ie virtual do_*)
 // functions go in ctype.cc
-  
+
 _GLIBCXX_BEGIN_NAMESPACE(std)
 
   bool
@@ -54,7 +54,7 @@ _GLIBCXX_BEGIN_NAMESPACE(std)
   ctype<char>::
   scan_is(mask __m, const char* __low, const char* __high) const
   {
-    while (__low < __high 
+    while (__low < __high
           && !(_M_table[static_cast<unsigned char>(*__low)] & __m))
       ++__low;
     return __low;
@@ -64,7 +64,7 @@ _GLIBCXX_BEGIN_NAMESPACE(std)
   ctype<char>::
   scan_not(mask __m, const char* __low, const char* __high) const
   {
-    while (__low < __high 
+    while (__low < __high
           && (_M_table[static_cast<unsigned char>(*__low)] & __m) != 0)
       ++__low;
     return __low;
index e7eac1b..68e9713 100644 (file)
@@ -23,9 +23,9 @@
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file ctype_noninline.h
+/** @file bits/ctype_noninline.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{locale}
  */
 
 //
index f9d11d1..ac8c28c 100644 (file)
@@ -22,9 +22,9 @@
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file os_defines.h
+/** @file bits/os_defines.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{iosfwd}
  */
 
 #ifndef _GLIBCXX_OS_DEFINES
index 6221e73..929d710 100644 (file)
@@ -22,9 +22,9 @@
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file ctype_inline.h
+/** @file bits/ctype_inline.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{locale}
  */
 
 //
index ee6d5e3..a2d9119 100644 (file)
@@ -23,9 +23,9 @@
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file ctype_noninline.h
+/** @file bits/ctype_noninline.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{locale}
  */
 
 //
index 4661bfb..b436f47 100644 (file)
@@ -22,9 +22,9 @@
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file os_defines.h
+/** @file bits/os_defines.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{iosfwd}
  */
 
 #ifndef _GLIBCXX_OS_DEFINES
diff --git a/libstdc++-v3/doc/doxygen/TODO b/libstdc++-v3/doc/doxygen/TODO
deleted file mode 100644 (file)
index d50c65d..0000000
+++ /dev/null
@@ -1,70 +0,0 @@
-
-The approach I've been using for a given header is to recursively do each
-of the "bits" headers which make up the standard header.  So, e.g., while
-there are four headers making up <algorithm>, three of them were already
-documented in the course of doing other headers.
-
-"Untouched" means I've deliberately skipped it for various reasons, or
-haven't gotten to it yet.  It /will/ be done (by somebody, eventually.)
-
-If you document an area and need to skip (for whatever reason) a non-trivial
-entity (i.e., one that should be documented), go ahead and add the comment
-markup, and use the homegrown @doctodo tag.  See include/bits/stl_iterator.h
-for examples of this.  Doing so will at least cause doxygen to consider the
-entitiy as documented and include it in the output.  It will also add the
-entity to the generated TODO page.
-
-
- Area           Still needs to be doxygen-documented
------------------------------------------------------------
-
-c17             FINISHED (Nothing in Clause 17 "exists" in terms of code.)
-c18             FINISHED, Note A
-c19             Note A
-c20             Note A
-c21             Public functions basic_string done, Note B
-c22             Most still to do; see docs/html/22_locale/*
-c23             See doxygroups.cc and Note B.  Notes on what invalidates
-                iterators need to be added.
-c24             stl_iterator.h (__normal_iterator, other small TODO bits)
-                stream iterators
-c25             stl_algo.h (lots of stuff)
-c26             <complex>, <valarray>, stl_numeric.h[26.4], Note A
-c27             ios_base callbacks and local storage
-                basic_ios::copyfmt()
-                std_streambuf.h's __copy_streambufs()
-                    " "           _M_* protected memfns (data has been done)
-                fstream and sstream protected members
-
-backward/*      Not scanned by doxygen.  Should it be?  Doubtful.
-
-ext/*           Some of the SGI algorithm/functional extensions.
-                All of rope/hashing/slist need docs.
-
-__gnu_cxx       Tricky.  Right now ext/* are in this namespace.
-
------------------------------------------------------------
-
-NOTES:
-
-A)  So far I have not tried to document any of the <c*> headers.  So entities
-such as atexit() are undocumented throughout the library.  Since we usually
-do not have the C code (to which the doxygen comments would be attached),
-this would need to be done in entirely separate files, a la doxygroups.cc.
-
-B)  Huge chunks of containers and strings are described in common "Tables"
-in the standard.  These are pseudo-duplicated in tables.html.  We can
-use doxygen hooks like @pre and @see to reference the tables.  Then the
-individual classes do like the standard does, and only document members for
-which additional info is available.
-
-
-STYLE:
-stl_deque.h, stl_pair.h, and stl_algobase.h have good examples of what I've
-been using for class, namespace-scope, and function documentation, respectively.
-These should serve as starting points.  /Please/ maintain the inter-word and
-inter-sentence spacing, as this might be generated and/or scanned in the
-future.
-
-
-vim:ts=4:et:
index 6d167ac..c9b2df8 100644 (file)
@@ -1,14 +1,14 @@
-# Doxyfile 1.7.1
+# Doxyfile 1.7.2
 
 # This file describes the settings to be used by the documentation system
-# doxygen (www.doxygen.org) for a project
+# doxygen (www.doxygen.org) for a project.
 #
-# All text after a hash (#) is considered a comment and will be ignored
+# All text after a hash (#) is considered a comment and will be ignored.
 # The format is:
 #       TAG = value [value, ...]
 # For lists items can also be appended using:
 #       TAG += value [value, ...]
-# Values that contain spaces should be placed between quotes (" ")
+# Values that contain spaces should be placed between quotes (" ").
 
 #---------------------------------------------------------------------------
 # Project related configuration options
@@ -126,7 +126,7 @@ STRIP_FROM_PATH        =
 STRIP_FROM_INC_PATH    =
 
 # If the SHORT_NAMES tag is set to YES, doxygen will generate much shorter
-# (but less readable) file names. This can be useful is your file systems
+# (but less readable) file names. This can be useful if your file system
 # doesn't support long names like on DOS, Mac, or CD-ROM.
 
 SHORT_NAMES            = @shortname@
@@ -179,8 +179,10 @@ TAB_SIZE               = 4
 # will result in a user-defined paragraph with heading "Side Effects:".
 # You can put \n's in the value part of an alias to insert newlines.
 
-ALIASES                = "doctodo=@todo\nDoc me!  See doc/doxygen/TODO and http://gcc.gnu.org/ml/libstdc++/2002-02/msg00003.html for more.  " \
-                        "isiosfwd=One of the @link io I/O @endlink typedefs"
+ALIASES = doctodo="@todo\nNeeds documentation! See http://gcc.gnu.org/onlinedocs/libstdc++/manual/documentation_style.html"
+
+ALIASES += headername{1}="Instead, include <\1>."
+ALIASES += headername{2}="Instead, include <\1> or <\2>."
 
 # Set the OPTIMIZE_OUTPUT_FOR_C tag to YES if your project consists of C
 # sources only. Doxygen will then generate output that is more tailored for C.
@@ -224,7 +226,7 @@ EXTENSION_MAPPING      =
 # to include (a tag file for) the STL sources as input, then you should
 # set this tag to YES in order to let doxygen match functions declarations and
 # definitions whose arguments contain STL classes (e.g. func(std::string); v.s.
-# func(std::string) {}). This also make the inheritance and collaboration
+# func(std::string) {}). This also makes the inheritance and collaboration
 # diagrams that involve STL classes more complete and accurate.
 
 BUILTIN_STL_SUPPORT    = NO
@@ -242,7 +244,7 @@ SIP_SUPPORT            = NO
 
 # For Microsoft's IDL there are propget and propput attributes to indicate getter
 # and setter methods for a property. Setting this option to YES (the default)
-# will make doxygen to replace the get and set methods by a property in the
+# will make doxygen replace the get and set methods by a property in the
 # documentation. This will only work if the methods are indeed getting or
 # setting a simple type. If this is not the case, or you want to show the
 # methods anyway, you should set this option to NO.
@@ -283,7 +285,7 @@ TYPEDEF_HIDES_STRUCT   = NO
 # causing a significant performance penality.
 # If the system has enough physical memory increasing the cache will improve the
 # performance by keeping more symbols in memory. Note that the value works on
-# a logarithmic scale so increasing the size by one will rougly double the
+# a logarithmic scale so increasing the size by one will roughly double the
 # memory usage. The cache size is given by this formula:
 # 2^(16+SYMBOL_CACHE_SIZE). The valid range is 0..9, the default is 0,
 # corresponding to a cache size of 2^16 = 65536 symbols
@@ -328,7 +330,7 @@ EXTRACT_LOCAL_METHODS  = YES
 # extracted and appear in the documentation as a namespace called
 # 'anonymous_namespace{file}', where file will be replaced with the base
 # name of the file that contains the anonymous namespace. By default
-# anonymous namespace are hidden.
+# anonymous namespaces are hidden.
 
 EXTRACT_ANON_NSPACES   = NO
 
@@ -469,10 +471,10 @@ GENERATE_DEPRECATEDLIST= YES
 ENABLED_SECTIONS       = @enabled_sections@
 
 # The MAX_INITIALIZER_LINES tag determines the maximum number of lines
-# the initial value of a variable or define consists of for it to appear in
+# the initial value of a variable or macro consists of for it to appear in
 # the documentation. If the initializer consists of more lines than specified
 # here it will be hidden. Use a value of 0 to hide initializers completely.
-# The appearance of the initializer of individual variables and defines in the
+# The appearance of the initializer of individual variables and macros in the
 # documentation can be controlled using \showinitializer or \hideinitializer
 # command in the documentation regardless of this setting.
 
@@ -550,7 +552,7 @@ WARN_IF_UNDOCUMENTED   = NO
 
 WARN_IF_DOC_ERROR      = YES
 
-# This WARN_NO_PARAMDOC option can be abled to get warnings for
+# The WARN_NO_PARAMDOC option can be enabled to get warnings for
 # functions that are documented, but have no documentation for their parameters
 # or return value. If set to NO (the default) doxygen will only warn about
 # wrong or incomplete parameter documentation, but not about the absence of
@@ -583,146 +585,146 @@ WARN_LOGFILE           =
 # with spaces.
 
 INPUT                  = @srcdir@/doc/doxygen/doxygroups.cc \
-                        @srcdir@/libsupc++/cxxabi.h \
-                        @srcdir@/libsupc++/cxxabi-forced.h \
-                        @srcdir@/libsupc++/exception \
-                        @srcdir@/libsupc++/exception_defines.h \
-                        @srcdir@/libsupc++/exception_ptr.h \
-                        @srcdir@/libsupc++/initializer_list \
-                        @srcdir@/libsupc++/nested_exception.h \
-                        @srcdir@/libsupc++/new \
-                        @srcdir@/libsupc++/typeinfo \
-                        include/algorithm \
-                        include/array \
-                        include/atomic \
-                        include/bitset \
-                        include/chrono \
-                        include/complex \
-                        include/condition_variable \
-                        include/deque \
-                        include/forward_list \
-                        include/fstream \
-                        include/functional \
-                        include/future \
-                        include/iomanip \
-                        include/ios \
-                        include/iosfwd \
-                        include/iostream \
-                        include/istream \
-                        include/iterator \
-                        include/limits \
-                        include/list \
-                        include/locale \
-                        include/map \
-                        include/memory \
-                        include/mutex \
-                        include/numeric \
-                        include/ostream \
-                        include/queue \
-                        include/random \
-                        include/ratio \
-                        include/regex \
-                        include/set \
-                        include/sstream \
-                        include/stack \
-                        include/stdexcept \
-                        include/streambuf \
-                        include/string \
-                        include/system_error \
-                        include/thread \
-                        include/tuple \
-                        include/typeindex \
-                        include/type_traits \
-                        include/unordered_map \
-                        include/unordered_set \
-                        include/utility \
-                        include/valarray \
-                        include/vector \
-                        include/cassert \
-                        include/ccomplex \
-                        include/cctype \
-                        include/cerrno \
-                        include/cfenv \
-                        include/cfloat \
-                        include/cinttypes \
-                        include/ciso646 \
-                        include/climits \
-                        include/clocale \
-                        include/cmath \
-                        include/csetjmp \
-                        include/csignal \
-                        include/cstdarg \
-                        include/cstdbool \
-                        include/cstddef \
-                        include/cstdint \
-                        include/cstdio \
-                        include/cstdlib \
-                        include/cstring \
-                        include/ctgmath \
-                        include/ctime \
-                        include/cwchar \
-                        include/cwctype \
-                        include/backward/hash_map \
-                        include/backward/hash_set \
-                        include/backward/strstream \
-                        include/debug/bitset \
-                        include/debug/deque \
-                        include/debug/forward_list \
-                        include/debug/list \
-                        include/debug/map \
-                        include/debug/set \
-                        include/debug/string \
-                        include/debug/unordered_map \
-                        include/debug/unordered_set \
-                        include/debug/vector \
-                        include/profile/bitset \
-                        include/profile/deque \
-                        include/profile/forward_list \
-                        include/profile/list \
-                        include/profile/map \
-                        include/profile/set \
-                        include/profile/unordered_map \
-                        include/profile/unordered_set \
-                        include/profile/vector \
-                        include/ext/algorithm \
-                        include/ext/functional \
-                        include/ext/iterator \
-                        include/ext/memory \
-                        include/ext/numeric \
-                        include/ext/rb_tree \
-                        include/ext/rope \
-                        include/ext/slist \
-                        include/parallel/algorithm \
-                        include/parallel/numeric \
-                        include/tr1/ccomplex \
-                        include/tr1/cctype \
-                        include/tr1/cfenv \
-                        include/tr1/cfloat \
-                        include/tr1/cinttypes \
-                        include/tr1/climits \
-                        include/tr1/cmath \
-                        include/tr1/complex \
-                        include/tr1/cstdarg \
-                        include/tr1/cstdbool \
-                        include/tr1/cstdint \
-                        include/tr1/cstdio \
-                        include/tr1/cstdlib \
-                        include/tr1/ctgmath \
-                        include/tr1/ctime \
-                        include/tr1/cwchar \
-                        include/tr1/cwctype \
-                        include/decimal/decimal \
-                        include/ \
-                        include/@host_alias@/bits \
-                        include/backward \
-                        include/bits \
-                        include/debug \
-                        include/parallel \
-                        include/profile \
-                        include/profile/impl \
-                        include/ext \
-                        include/ext/pb_ds \
-                        include/ext/pb_ds/detail
+                         @srcdir@/libsupc++/cxxabi.h \
+                         @srcdir@/libsupc++/cxxabi-forced.h \
+                         @srcdir@/libsupc++/exception \
+                         @srcdir@/libsupc++/exception_defines.h \
+                         @srcdir@/libsupc++/exception_ptr.h \
+                         @srcdir@/libsupc++/initializer_list \
+                         @srcdir@/libsupc++/nested_exception.h \
+                         @srcdir@/libsupc++/new \
+                         @srcdir@/libsupc++/typeinfo \
+                         include/algorithm \
+                         include/array \
+                         include/atomic \
+                         include/bitset \
+                         include/chrono \
+                         include/complex \
+                         include/condition_variable \
+                         include/deque \
+                         include/forward_list \
+                         include/fstream \
+                         include/functional \
+                         include/future \
+                         include/iomanip \
+                         include/ios \
+                         include/iosfwd \
+                         include/iostream \
+                         include/istream \
+                         include/iterator \
+                         include/limits \
+                         include/list \
+                         include/locale \
+                         include/map \
+                         include/memory \
+                         include/mutex \
+                         include/numeric \
+                         include/ostream \
+                         include/queue \
+                         include/random \
+                         include/ratio \
+                         include/regex \
+                         include/set \
+                         include/sstream \
+                         include/stack \
+                         include/stdexcept \
+                         include/streambuf \
+                         include/string \
+                         include/system_error \
+                         include/thread \
+                         include/tuple \
+                         include/typeindex \
+                         include/type_traits \
+                         include/unordered_map \
+                         include/unordered_set \
+                         include/utility \
+                         include/valarray \
+                         include/vector \
+                         include/cassert \
+                         include/ccomplex \
+                         include/cctype \
+                         include/cerrno \
+                         include/cfenv \
+                         include/cfloat \
+                         include/cinttypes \
+                         include/ciso646 \
+                         include/climits \
+                         include/clocale \
+                         include/cmath \
+                         include/csetjmp \
+                         include/csignal \
+                         include/cstdarg \
+                         include/cstdbool \
+                         include/cstddef \
+                         include/cstdint \
+                         include/cstdio \
+                         include/cstdlib \
+                         include/cstring \
+                         include/ctgmath \
+                         include/ctime \
+                         include/cwchar \
+                         include/cwctype \
+                         include/backward/hash_map \
+                         include/backward/hash_set \
+                         include/backward/strstream \
+                         include/debug/bitset \
+                         include/debug/deque \
+                         include/debug/forward_list \
+                         include/debug/list \
+                         include/debug/map \
+                         include/debug/set \
+                         include/debug/string \
+                         include/debug/unordered_map \
+                         include/debug/unordered_set \
+                         include/debug/vector \
+                         include/profile/bitset \
+                         include/profile/deque \
+                         include/profile/forward_list \
+                         include/profile/list \
+                         include/profile/map \
+                         include/profile/set \
+                         include/profile/unordered_map \
+                         include/profile/unordered_set \
+                         include/profile/vector \
+                         include/ext/algorithm \
+                         include/ext/functional \
+                         include/ext/iterator \
+                         include/ext/memory \
+                         include/ext/numeric \
+                         include/ext/rb_tree \
+                         include/ext/rope \
+                         include/ext/slist \
+                         include/parallel/algorithm \
+                         include/parallel/numeric \
+                         include/tr1/ccomplex \
+                         include/tr1/cctype \
+                         include/tr1/cfenv \
+                         include/tr1/cfloat \
+                         include/tr1/cinttypes \
+                         include/tr1/climits \
+                         include/tr1/cmath \
+                         include/tr1/complex \
+                         include/tr1/cstdarg \
+                         include/tr1/cstdbool \
+                         include/tr1/cstdint \
+                         include/tr1/cstdio \
+                         include/tr1/cstdlib \
+                         include/tr1/ctgmath \
+                         include/tr1/ctime \
+                         include/tr1/cwchar \
+                         include/tr1/cwctype \
+                         include/decimal/decimal \
+                         include/ \
+                         include/@host_alias@/bits \
+                         include/backward \
+                         include/bits \
+                         include/debug \
+                         include/parallel \
+                         include/profile \
+                         include/profile/impl \
+                         include/ext \
+                         include/ext/pb_ds \
+                         include/ext/pb_ds/detail
 
 # This tag can be used to specify the character encoding of the source files
 # that doxygen parses. Internally doxygen uses the UTF-8 encoding, which is
@@ -736,12 +738,13 @@ INPUT_ENCODING         = UTF-8
 # FILE_PATTERNS tag to specify one or more wildcard pattern (like *.cpp
 # and *.h) to filter out the source-files in the directories. If left
 # blank the following patterns are tested:
-# *.c *.cc *.cxx *.cpp *.c++ *.java *.ii *.ixx *.ipp *.i++ *.inl *.h *.hh *.hxx
-# *.hpp *.h++ *.idl *.odl *.cs *.php *.php3 *.inc *.m *.mm *.py *.f90
+# *.c *.cc *.cxx *.cpp *.c++ *.d *.java *.ii *.ixx *.ipp *.i++ *.inl *.h *.hh
+# *.hxx *.hpp *.h++ *.idl *.odl *.cs *.php *.php3 *.inc *.m *.mm *.dox *.py
+# *.f90 *.f *.vhd *.vhdl
 
 FILE_PATTERNS          = *.h \
-                        *.hpp \
-                        *.tcc
+                         *.hpp \
+                         *.tcc
 
 # The RECURSIVE tag can be used to turn specify whether or not subdirectories
 # should be searched for input files as well. Possible values are YES and NO.
@@ -767,9 +770,9 @@ EXCLUDE_SYMLINKS       = NO
 # against the file with absolute path, so to exclude all test directories
 # for example use the pattern */test/*
 
-EXCLUDE_PATTERNS       = stamp-* \
-                        *.gch \
-                        */.svn/*
+EXCLUDE_PATTERNS       = stamp-* doxygroups.cc \
+                         *.gch \
+                         */.svn/*
 
 # The EXCLUDE_SYMBOLS tag can be used to specify one or more symbol names
 # (namespaces, classes, functions, etc.) that should be excluded from the
@@ -1026,10 +1029,9 @@ DOCSET_FEEDNAME        = "Doxygen generated docs"
 
 DOCSET_BUNDLE_ID       = org.gnu.libstdc++
 
-# When GENERATE_PUBLISHER_ID tag specifies a string that should
-# uniquely identify the documentation publisher. This should be a
-# reverse domain-name style string,
-# e.g. com.mycompany.MyDocSet.documentation.
+# When GENERATE_PUBLISHER_ID tag specifies a string that should uniquely identify
+# the documentation publisher. This should be a reverse domain-name style
+# string, e.g. com.mycompany.MyDocSet.documentation.
 
 DOCSET_PUBLISHER_ID    = org.fsf
 
@@ -1157,8 +1159,9 @@ ECLIPSE_DOC_ID         = org.doxygen.Project
 
 DISABLE_INDEX          = YES
 
-# This tag can be used to set the number of enum values (range [1..20])
+# This tag can be used to set the number of enum values (range [0,1..20])
 # that doxygen will group on one line in the generated HTML documentation.
+# Note that a value of 0 will completely suppress the enum values from appearing in the overview section.
 
 ENUM_VALUES_PER_LINE   = 4
 
@@ -1204,6 +1207,25 @@ FORMULA_FONTSIZE       = 10
 
 FORMULA_TRANSPARENT    = YES
 
+# Enable the USE_MATHJAX option to render LaTeX formulas using MathJax
+# (see http://www.mathjax.org) which uses client side Javascript for the
+# rendering instead of using prerendered bitmaps. Use this if you do not
+# have LaTeX installed or if you want to formulas look prettier in the HTML
+# output. When enabled you also need to install MathJax separately and
+# configure the path to it using the MATHJAX_RELPATH option.
+
+USE_MATHJAX            = NO
+
+# When MathJax is enabled you need to specify the location relative to the
+# HTML output directory using the MATHJAX_RELPATH option. The destination
+# directory should contain the MathJax.js script. For instance, if the mathjax
+# directory is located at the same level as the HTML output directory, then
+# MATHJAX_RELPATH should be ../mathjax. The default value points to the mathjax.org site, so you can quickly see the result without installing
+# MathJax, but it is strongly recommended to install a local copy of MathJax
+# before deployment.
+
+MATHJAX_RELPATH        = http://www.mathjax.org/mathjax
+
 # When the SEARCHENGINE tag is enabled doxygen will generate a search box
 # for the HTML output. The underlying search engine uses javascript
 # and DHTML and should work on any modern browser. Note that when using
@@ -1219,7 +1241,7 @@ SEARCHENGINE           = NO
 # using Javascript. Doxygen will generate the search PHP script and index
 # file to put on the web server. The advantage of the server
 # based approach is that it scales better to large projects and allows
-# full text search. The disadvances is that it is more difficult to setup
+# full text search. The disadvantages are that it is more difficult to setup
 # and does not have live searching capabilities.
 
 SERVER_BASED_SEARCH    = NO
@@ -1260,7 +1282,7 @@ MAKEINDEX_CMD_NAME     = makeindex
 COMPACT_LATEX          = NO
 
 # The PAPER_TYPE tag can be used to set the paper type that is used
-# by the printer. Possible values are: a4, a4wide, letter, legal and
+# by the printer. Possible values are: a4, letter, legal and
 # executive. If left blank a4wide will be used.
 
 PAPER_TYPE             = letter
@@ -1512,44 +1534,44 @@ INCLUDE_FILE_PATTERNS  =
 # instead of the = operator.
 
 PREDEFINED             = __cplusplus \
-                        __GTHREADS \
-                        _GLIBCXX_HAS_GTHREADS \
-                        __GXX_EXPERIMENTAL_CXX0X__ \
-                        _GLIBCXX_INCLUDE_AS_CXX0X \
-                        "_GLIBCXX_PURE= " \
-                        "_GLIBCXX_CONST= " \
-                        "_GLIBCXX_NORETURN= " \
-                        "_GLIBCXX_NOTHROW= " \
-                        "_GLIBCXX_STD_D= " \
-                        "_GLIBCXX_STD_P= " \
-                        "_GLIBCXX_STD_PR= " \
-                        _GLIBCXX_STD=std \
-                        "_GLIBCXX_TR1= " \
-                        "_GLIBCXX_BEGIN_NAMESPACE_TR1= " \
-                        "_GLIBCXX_END_NAMESPACE_TR1= " \
-                        "_GLIBCXX_BEGIN_NAMESPACE(name)=namespace name {  " \
-                        "_GLIBCXX_BEGIN_NESTED_NAMESPACE(name, unused)=namespace name {  " \
-                        _GLIBCXX_END_NAMESPACE=} \
-                        _GLIBCXX_END_NESTED_NAMESPACE=} \
-                        "_GLIBCXX_TEMPLATE_ARGS=...  " \
-                        _GLIBCXX_DEPRECATED \
-                        _GLIBCXX_CONSTEXPR=constexpr \
-                        _GLIBCXX_USE_CONSTEXPR=constexpr \
-                        _GLIBCXX_USE_WCHAR_T \
-                        _GLIBCXX_USE_LONG_LONG \
-                        _GLIBCXX_USE_C99_STDINT_TR1 \
-                        _GLIBCXX_ATOMIC_BUILTINS_1 \
-                        _GLIBCXX_ATOMIC_BUILTINS_2 \
-                        _GLIBCXX_ATOMIC_BUILTINS_4 \
-                        _GLIBCXX_ATOMIC_BUILTINS_8 \
-                        _GLIBCXX_USE_SCHED_YIELD \
-                        _GLIBCXX_USE_NANOSLEEP \
-                        __GXX_RTTI \
-                        __glibcxx_function_requires=// \
-                        __glibcxx_class_requires=// \
-                        __glibcxx_class_requires2=// \
-                        __glibcxx_class_requires3=// \
-                        __glibcxx_class_requires4=//
+                         __GTHREADS \
+                         _GLIBCXX_HAS_GTHREADS \
+                         __GXX_EXPERIMENTAL_CXX0X__ \
+                         _GLIBCXX_INCLUDE_AS_CXX0X \
+                         "_GLIBCXX_PURE= " \
+                         "_GLIBCXX_CONST= " \
+                         "_GLIBCXX_NORETURN= " \
+                         "_GLIBCXX_NOTHROW= " \
+                         "_GLIBCXX_STD_D= " \
+                         "_GLIBCXX_STD_P= " \
+                         "_GLIBCXX_STD_PR= " \
+                         _GLIBCXX_STD=std \
+                         "_GLIBCXX_TR1= " \
+                         "_GLIBCXX_BEGIN_NAMESPACE_TR1= " \
+                         "_GLIBCXX_END_NAMESPACE_TR1= " \
+                         "_GLIBCXX_BEGIN_NAMESPACE(name)=namespace name {  " \
+                         "_GLIBCXX_BEGIN_NESTED_NAMESPACE(name, unused)=namespace name {  " \
+                         _GLIBCXX_END_NAMESPACE=} \
+                         _GLIBCXX_END_NESTED_NAMESPACE=} \
+                         "_GLIBCXX_TEMPLATE_ARGS=...  " \
+                         _GLIBCXX_DEPRECATED \
+                         _GLIBCXX_CONSTEXPR=constexpr \
+                         _GLIBCXX_USE_CONSTEXPR=constexpr \
+                         _GLIBCXX_USE_WCHAR_T \
+                         _GLIBCXX_USE_LONG_LONG \
+                         _GLIBCXX_USE_C99_STDINT_TR1 \
+                         _GLIBCXX_ATOMIC_BUILTINS_1 \
+                         _GLIBCXX_ATOMIC_BUILTINS_2 \
+                         _GLIBCXX_ATOMIC_BUILTINS_4 \
+                         _GLIBCXX_ATOMIC_BUILTINS_8 \
+                         _GLIBCXX_USE_SCHED_YIELD \
+                         _GLIBCXX_USE_NANOSLEEP \
+                         __GXX_RTTI \
+                         __glibcxx_function_requires=// \
+                         __glibcxx_class_requires=// \
+                         __glibcxx_class_requires2=// \
+                         __glibcxx_class_requires3=// \
+                         __glibcxx_class_requires4=//
 
 # If the MACRO_EXPANSION and EXPAND_ONLY_PREDEF tags are set to YES then
 # this tag can be used to specify a list of macro names that should be expanded.
@@ -1618,9 +1640,8 @@ PERL_PATH              = /usr/bin/perl
 # If the CLASS_DIAGRAMS tag is set to YES (the default) Doxygen will
 # generate a inheritance diagram (in HTML, RTF and LaTeX) for classes with base
 # or super classes. Setting the tag to NO turns the diagrams off. Note that
-# this option is superseded by the HAVE_DOT option below. This is only a
-# fallback. It is recommended to install and use dot, since it yields more
-# powerful graphs.
+# this option also works with HAVE_DOT disabled, but it is recommended to
+# install and use dot, since it yields more powerful graphs.
 
 CLASS_DIAGRAMS         = YES
 
@@ -1654,15 +1675,14 @@ HAVE_DOT               = YES
 
 DOT_NUM_THREADS        = 0
 
-# By default doxygen will write a font called FreeSans.ttf to the
-# output directory and reference it in all dot files that doxygen
-# generates. This font does not include all possible unicode
-# characters however, so when you need these (or just want a
-# differently looking font) you can specify the font name using
-# DOT_FONTNAME. You need need to make sure dot is able to find the
-# font, which can be done by putting it in a standard location or by
-# setting the DOTFONTPATH environment variable or by setting
-# DOT_FONTPATH to the directory containing the font.
+# By default doxygen will write a font called FreeSans.ttf to the output
+# directory and reference it in all dot files that doxygen generates. This
+# font does not include all possible unicode characters however, so when you need
+# these (or just want a differently looking font) you can specify the font name
+# using DOT_FONTNAME. You need need to make sure dot is able to find the font,
+# which can be done by putting it in a standard location or by setting the
+# DOTFONTPATH environment variable or by setting DOT_FONTPATH to the directory
+# containing the font.
 
 DOT_FONTNAME           = FreeSans
 
@@ -1739,7 +1759,7 @@ CALL_GRAPH             = NO
 CALLER_GRAPH           = NO
 
 # If the GRAPHICAL_HIERARCHY and HAVE_DOT tags are set to YES then doxygen
-# will graphical hierarchy of all classes instead of a textual one.
+# will generate a graphical hierarchy of all classes instead of a textual one.
 
 GRAPHICAL_HIERARCHY    = YES
 
@@ -1751,7 +1771,7 @@ GRAPHICAL_HIERARCHY    = YES
 DIRECTORY_GRAPH        = YES
 
 # The DOT_IMAGE_FORMAT tag can be used to set the image format of the images
-# generated by dot. Possible values are png, jpg, or gif
+# generated by dot. Possible values are png, jpg, or gif.
 # If left blank png will be used.
 
 DOT_IMAGE_FORMAT       = png
@@ -1767,6 +1787,12 @@ DOT_PATH               =
 
 DOTFILE_DIRS           =
 
+# The MSCFILE_DIRS tag can be used to specify one or more directories that
+# contain msc files that are included in the documentation (see the
+# \mscfile command).
+
+MSCFILE_DIRS           =
+
 # The DOT_GRAPH_MAX_NODES tag can be used to set the maximum number of
 # nodes that will be shown in the graph. If the number of nodes in a graph
 # becomes larger than this value, doxygen will truncate the graph, which is
index cf541bc..9fad4ce 100644 (file)
@@ -24,7 +24,7 @@
 
 /** @file bits/algorithmfwd.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{algorithm}
  */
 
 #ifndef _GLIBCXX_ALGORITHMFWD_H
index 70327ac..4300679 100644 (file)
@@ -36,9 +36,9 @@
  * purpose.  It is provided "as is" without express or implied warranty.
  */
 
-/** @file allocator.h
+/** @file bits/allocator.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{memory}
  */
 
 #ifndef _ALLOCATOR_H
index 8daf416..eaff2e6 100644 (file)
@@ -25,7 +25,7 @@
 
 /** @file bits/atomic_0.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{atomic}
  */
 
 #ifndef _GLIBCXX_ATOMIC_0_H
index e4cf24d..85f8c0f 100644 (file)
@@ -23,9 +23,9 @@
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file bits/atomic_2.h
+/** @file bits/atomic_2.h 
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{atomic}
  */
 
 #ifndef _GLIBCXX_ATOMIC_2_H
index 7c89de2..74fc997 100644 (file)
@@ -22,9 +22,9 @@
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file bits/atomic_base.h
+/** @file bits/atomic_base.h 
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{atomic}
  */
 
 #ifndef _GLIBCXX_ATOMIC_BASE_H
index ba06316..71e7f28 100644 (file)
@@ -24,9 +24,9 @@
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file basic_ios.h
+/** @file bits/basic_ios.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{ios}
  */
 
 #ifndef _BASIC_IOS_H
index a0dc67e..73a72fb 100644 (file)
@@ -23,9 +23,9 @@
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file basic_ios.tcc
+/** @file bits/basic_ios.tcc
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{ios}
  */
 
 #ifndef _BASIC_IOS_TCC
index 2fc99d5..eb27e67 100644 (file)
@@ -24,9 +24,9 @@
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file basic_string.h
+/** @file bits/basic_string.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{string}
  */
 
 //
index ab71ad6..a64c781 100644 (file)
@@ -24,9 +24,9 @@
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file basic_string.tcc
+/** @file bits/basic_string.tcc
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{string}
  */
 
 //
index cffd7fb..beabbb5 100644 (file)
@@ -30,9 +30,9 @@
 // to its suitability for any purpose.
 //
 
-/** @file boost_concept_check.h
+/** @file bits/boost_concept_check.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{iterator}
  */
 
 // GCC Note:  based on version 1.12.0 of the Boost library.
index 4f926a3..0685a50 100644 (file)
@@ -20,8 +20,9 @@
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file c++0x_warning.h
- *  This is a Standard C++ Library header.
+/** @file bits/c++0x_warning.h
+ *  This is an internal header file, included by other library headers.
+ *  Do not attempt to use it directly. @headername{iosfwd}
  */
 
 #ifndef _CXX0X_WARNING_H
index 1c556eb..400c244 100644 (file)
@@ -23,9 +23,9 @@
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file c++config.h
+/** @file bits/c++config.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{iosfwd}
  */
 
 #ifndef _GLIBCXX_CXX_CONFIG_H
index 2c1a5fd..4033f6d 100644 (file)
@@ -24,9 +24,9 @@
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file char_traits.h
+/** @file bits/char_traits.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{string}
  */
 
 //
index 98ca3ae..cf8ac10 100644 (file)
@@ -25,7 +25,7 @@
 
 /** @file bits/codecvt.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{locale}
  */
 
 //
index 6d45e26..7978a85 100644 (file)
@@ -22,9 +22,9 @@
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file concept_check.h
+/** @file bits/concept_check.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{iterator}
  */
 
 #ifndef _CONCEPT_CHECK_H
index 0d7b9ff..3ae964a 100644 (file)
@@ -23,9 +23,9 @@
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file cpp_type_traits.h
+/** @file bits/cpp_type_traits.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{ext/type_traits}
  */
 
 // Written by Gabriel Dos Reis <dosreis@cmla.ens-cachan.fr>
index d8c2787..78bb888 100644 (file)
@@ -50,9 +50,9 @@
  * purpose.  It is provided "as is" without express or implied warranty.
  */
 
-/** @file deque.tcc
+/** @file bits/deque.tcc
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{deque}
  */
 
 #ifndef _DEQUE_TCC
index 845090e..b7f071f 100644 (file)
@@ -22,8 +22,9 @@
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file forward_list.h
- *  This is a Standard C++ Library header.
+/** @file bits/forward_list.h
+ *  This is an internal header file, included by other library headers.
+ *  Do not attempt to use it directly. @headername{forward_list}
  */
 
 #ifndef _FORWARD_LIST_H
index 264bf67..a409383 100644 (file)
@@ -22,8 +22,9 @@
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file forward_list.tcc
- *  This is a Standard C++ Library header.
+/** @file bits/forward_list.tcc
+ *  This is an internal header file, included by other library headers.
+ *  Do not attempt to use it directly. @headername{forward_list}
  */
 
 #ifndef _FORWARD_LIST_TCC
index d32de8f..6e00388 100644 (file)
@@ -24,9 +24,9 @@
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file fstream.tcc
+/** @file bits/fstream.tcc
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{fstream}
  */
 
 //
index 5b2e9fc..b16c360 100644 (file)
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file functexcept.h
+/** @file bits/functexcept.h
+ *  This is an internal header file, included by other library headers.
+ *  Do not attempt to use it directly. @headername{exception}
+ *
  *  This header provides support for -fno-exceptions.
  */
 
index a132cce..6cf70b7 100644 (file)
@@ -24,7 +24,7 @@
 
 /** @file bits/functional_hash.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{functional}
  */
 
 #ifndef _FUNCTIONAL_HASH_H
index 29ba46a..6c2dfe8 100644 (file)
@@ -23,9 +23,9 @@
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file gslice.h
+/** @file bits/gslice.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{valarray}
  */
 
 // Written by Gabriel Dos Reis <Gabriel.Dos-Reis@DPTMaths.ENS-Cachan.Fr>
index 745a5a8..dbae978 100644 (file)
@@ -23,9 +23,9 @@
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file gslice_array.h
+/** @file bits/gslice_array.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{valarray}
  */
 
 // Written by Gabriel Dos Reis <Gabriel.Dos-Reis@DPTMaths.ENS-Cachan.Fr>
index 1f959d9..fd29c59 100644 (file)
@@ -25,6 +25,7 @@
 /** @file bits/hashtable.h
  *  This is an internal header file, included by other library headers.
  *  You should not attempt to use it directly.
+ *  @headername{unordered_map, unordered_set}
  */
 
 #ifndef _HASHTABLE_H
index d8d2af5..622784a 100644 (file)
@@ -24,7 +24,8 @@
 
 /** @file bits/hashtable_policy.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. 
+ *  @headername{unordered_map,unordered_set}
  */
 
 #ifndef _HASHTABLE_POLICY_H
index 4920394..eb646e2 100644 (file)
@@ -23,9 +23,9 @@
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file indirect_array.h
+/** @file bits/indirect_array.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{valarray}
  */
 
 // Written by Gabriel Dos Reis <Gabriel.Dos-Reis@DPTMaths.ENS-Cachan.Fr>
index f161a4d..24bddf2 100644 (file)
@@ -24,9 +24,9 @@
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file ios_base.h
+/** @file bits/ios_base.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{ios}
  */
 
 //
index e0a4cd3..394553e 100644 (file)
@@ -24,9 +24,9 @@
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file istream.tcc
+/** @file bits/istream.tcc
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{istream}
  */
 
 //
index 3446c42..b06822f 100644 (file)
@@ -49,9 +49,9 @@
  * purpose.  It is provided "as is" without express or implied warranty.
  */
 
-/** @file list.tcc
+/** @file bits/list.tcc
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{list}
  */
 
 #ifndef _LIST_TCC
index 8a846bc..4756ac5 100644 (file)
@@ -24,9 +24,9 @@
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file locale_classes.h
+/** @file bits/locale_classes.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{locale}
  */
 
 //
index 5dcf205..67a423b 100644 (file)
@@ -22,9 +22,9 @@
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file locale_classes.tcc
+/** @file bits/locale_classes.tcc
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{locale}
  */
 
 //
index 79bfd03..bb0ba26 100644 (file)
@@ -24,9 +24,9 @@
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file locale_facets.h
+/** @file bits/locale_facets.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{locale}
  */
 
 //
index 52bafd3..076963a 100644 (file)
@@ -24,9 +24,9 @@
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file locale_facets.tcc
+/** @file bits/locale_facets.tcc
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{locale}
  */
 
 #ifndef _LOCALE_FACETS_TCC
index fdff7f5..6d6af2b 100644 (file)
@@ -22,9 +22,9 @@
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file locale_facets_nonio.h
+/** @file bits/locale_facets_nonio.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{locale}
  */
 
 //
index 039cce2..35869e3 100644 (file)
@@ -22,9 +22,9 @@
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file locale_facets_nonio.tcc
+/** @file bits/locale_facets_nonio.tcc
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{locale}
  */
 
 #ifndef _LOCALE_FACETS_NONIO_TCC
index c81e39b..b7bf42e 100644 (file)
@@ -24,9 +24,9 @@
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file localefwd.h
+/** @file bits/localefwd.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{locale}
  */
 
 //
index f915dd9..af6f637 100644 (file)
@@ -23,9 +23,9 @@
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file mask_array.h
+/** @file bits/mask_array.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{valarray}
  */
 
 // Written by Gabriel Dos Reis <Gabriel.Dos-Reis@DPTMaths.ENS-Cachan.Fr>
index f351d01..5172f50 100644 (file)
@@ -22,9 +22,9 @@
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file move.h
+/** @file bits/move.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{utility}
  */
 
 #ifndef _MOVE_H
index 1147212..967b7b6 100644 (file)
@@ -24,9 +24,9 @@
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file ostream.tcc
+/** @file bits/ostream.tcc
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{ostream}
  */
 
 //
index e0017ee..3368ffe 100644 (file)
@@ -22,9 +22,9 @@
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file ostream_insert.h
+/** @file bits/ostream_insert.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{ostream}
  */
 
 #ifndef _OSTREAM_INSERT_H
index 8066d9b..46ef671 100644 (file)
@@ -1,7 +1,7 @@
 // Position types -*- C++ -*-
 
 // Copyright (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005,
-// 2006, 2007, 2008, 2009
+// 2006, 2007, 2008, 2009, 2010
 // Free Software Foundation, Inc.
 //
 // This file is part of the GNU ISO C++ Library.  This library is free
@@ -24,9 +24,9 @@
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file postypes.h
+/** @file bits/postypes.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{iosfwd}
  */
 
 //
index 2fa8e6c..9feb0f4 100644 (file)
@@ -25,7 +25,7 @@
 /**
  * @file bits/random.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{random}
  */
 
 #ifndef _RANDOM_H
index 323741d..43fd0c8 100644 (file)
@@ -24,7 +24,7 @@
 
 /** @file bits/random.tcc
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{random}
  */
 
 #ifndef _RANDOM_TCC
index e9bf67e..5c898ef 100644 (file)
@@ -24,7 +24,7 @@
 
 /** @file bits/range_access.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{iterator}
  */
 
 #ifndef _GLIBCXX_RANGE_ACCESS_H
index 807bf0d..ab05fc2 100644 (file)
@@ -23,9 +23,9 @@
 // <http://www.gnu.org/licenses/>.
 
 /**
- * @file bits/regex.h
+ *  @file bits/regex.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{regex}
  */
 
 _GLIBCXX_BEGIN_NAMESPACE(std)
index 90c96ff..4219c8b 100644 (file)
@@ -23,9 +23,9 @@
 // <http://www.gnu.org/licenses/>.
 
 /**
- * @file bits/regex_compiler.h
- * This is an internal header file, included by other library headers.
- * You should not attempt to use it directly.
+ *  @file bits/regex_compiler.h
+ *  This is an internal header file, included by other library headers.
+ *  Do not attempt to use it directly. @headername{regex}
  */
 
 _GLIBCXX_BEGIN_NAMESPACE(std)
index 15e2953..1aeef52 100644 (file)
 // <http://www.gnu.org/licenses/>.
 
 /**
- * @file bits/regex_constants.h
- * @brief Constant definitions for the std regex library.
+ *  @file bits/regex_constants.h
+ *  @brief Constant definitions for the std regex library.
  *
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{regex}
  */
 
 _GLIBCXX_BEGIN_NAMESPACE(std)
index 32ea8c9..fee7b43 100644 (file)
@@ -23,9 +23,9 @@
 // <http://www.gnu.org/licenses/>.
 
 /**
- * @file bits/regex_cursor.h
- * This is an internal header file, included by other library headers.
- * You should not attempt to use it directly.
+ *  @file bits/regex_cursor.h
+ *  This is an internal header file, included by other library headers.
+ *  Do not attempt to use it directly. @headername{regex}
  */
 
 _GLIBCXX_BEGIN_NAMESPACE(std)
index 91dd597..6308c30 100644 (file)
@@ -27,7 +27,7 @@
  * @brief Error and exception objects for the std regex library.
  *
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{regex}
  */
 
 _GLIBCXX_BEGIN_NAMESPACE(std)
index 470e629..67770e9 100644 (file)
@@ -23,9 +23,9 @@
 // <http://www.gnu.org/licenses/>.
 
 /**
- * @file bits/regex_grep_matcher.h
- * This is an internal header file, included by other library headers.
- * You should not attempt to use it directly.
+ *  @file bits/regex_grep_matcher.h
+ *  This is an internal header file, included by other library headers.
+ *  Do not attempt to use it directly. @headername{regex}
  */
 
 _GLIBCXX_BEGIN_NAMESPACE(std)
index 48e7482..804473f 100644 (file)
@@ -23,7 +23,9 @@
 // <http://www.gnu.org/licenses/>.
 
 /**
- * @file bits/regex_grep_matcher.tcc
+ *  @file bits/regex_grep_matcher.tcc
+ *  This is an internal header file, included by other library headers.
+ *  Do not attempt to use it directly. @headername{regex}
  */
 
 #include <regex>
index 0a41289..4a771ee 100644 (file)
@@ -23,9 +23,9 @@
 // <http://www.gnu.org/licenses/>.
 
 /**
- * @file bits/regex_nfa.h
- * This is an internal header file, included by other library headers.
- * You should not attempt to use it directly.
+ *  @file bits/regex_nfa.h
+ *  This is an internal header file, included by other library headers.
+ *  Do not attempt to use it directly. @headername{regex}
  */
 
 _GLIBCXX_BEGIN_NAMESPACE(std)
index 4a5d5ff..392b2c3 100644 (file)
@@ -24,6 +24,8 @@
 
 /**
  * @file bits/regex_nfa.tcc
+ *  This is an internal header file, included by other library headers.
+ *  Do not attempt to use it directly. @headername{regex}
  */
 #include <regex>
 
index 6dc9c9f..c9095d5 100644 (file)
@@ -43,7 +43,7 @@
 
 /** @file bits/shared_ptr.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{memory}
  */
 
 #ifndef _SHARED_PTR_H
index b333357..ba2f004 100644 (file)
@@ -43,7 +43,7 @@
 
 /** @file bits/shared_ptr_base.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{memory}
  */
 
 #ifndef _SHARED_PTR_BASE_H
index 566c764..3d84998 100644 (file)
@@ -23,9 +23,9 @@
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file slice_array.h
+/** @file bits/slice_array.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{valarray}
  */
 
 // Written by Gabriel Dos Reis <Gabriel.Dos-Reis@DPTMaths.ENS-Cachan.Fr>
index 0f9db8e..ed61f29 100644 (file)
@@ -24,9 +24,9 @@
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file sstream.tcc
+/** @file bits/sstream.tcc
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{sstream}
  */
 
 //
index 456c536..0fdc924 100644 (file)
@@ -49,9 +49,9 @@
  * purpose.  It is provided "as is" without express or implied warranty.
  */
 
-/** @file stl_algo.h
+/** @file bits/stl_algo.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{algorithm}
  */
 
 #ifndef _STL_ALGO_H
index 1d951aa..2c3b6af 100644 (file)
@@ -49,9 +49,9 @@
  * purpose.  It is provided "as is" without express or implied warranty.
  */
 
-/** @file stl_algobase.h
+/** @file bits/stl_algobase.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{algorithm}
  */
 
 #ifndef _STL_ALGOBASE_H
index 74c2e85..f35fd0a 100644 (file)
@@ -49,9 +49,9 @@
  * purpose.  It is provided "as is" without express or implied warranty.
  */
 
-/** @file stl_bvector.h
+/** @file bits/stl_bvector.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{vector}
  */
 
 #ifndef _STL_BVECTOR_H
index d84b8f1..31f65ee 100644 (file)
@@ -50,9 +50,9 @@
  * purpose.  It is provided "as is" without express or implied warranty.
  */
 
-/** @file stl_construct.h
+/** @file bits/stl_construct.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{memory}
  */
 
 #ifndef _STL_CONSTRUCT_H
index 397b633..c3b5d00 100644 (file)
@@ -49,9 +49,9 @@
  * purpose.  It is provided "as is" without express or implied warranty.
  */
 
-/** @file stl_deque.h
+/** @file bits/stl_deque.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{deque}
  */
 
 #ifndef _STL_DEQUE_H
index a5f5e25..630ca03 100644 (file)
@@ -49,9 +49,9 @@
  * purpose.  It is provided "as is" without express or implied warranty.
  */
 
-/** @file stl_function.h
+/** @file bits/stl_function.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{functional}
  */
 
 #ifndef _STL_FUNCTION_H
@@ -99,10 +99,11 @@ _GLIBCXX_BEGIN_NAMESPACE(std)
   template<typename _Arg, typename _Result>
     struct unary_function
     {
-      typedef _Arg argument_type;   ///< @c argument_type is the type of the
-                                    ///     argument (no surprises here)
+      /// @c argument_type is the type of the argument
+      typedef _Arg     argument_type;   
 
-      typedef _Result result_type;  ///< @c result_type is the return type
+      /// @c result_type is the return type
+      typedef _Result  result_type;  
     };
 
   /**
@@ -111,11 +112,14 @@ _GLIBCXX_BEGIN_NAMESPACE(std)
   template<typename _Arg1, typename _Arg2, typename _Result>
     struct binary_function
     {
-      typedef _Arg1 first_argument_type;   ///< the type of the first argument
-                                           ///  (no surprises here)
+      /// @c first_argument_type is the type of the first argument
+      typedef _Arg1    first_argument_type; 
 
-      typedef _Arg2 second_argument_type;  ///< the type of the second argument
-      typedef _Result result_type;         ///< type of the return type
+      /// @c second_argument_type is the type of the second argument
+      typedef _Arg2    second_argument_type;
+
+      /// @c result_type is the return type
+      typedef _Result  result_type;
     };
   /** @}  */
 
index b52fa7a..0c9641b 100644 (file)
@@ -48,9 +48,9 @@
  * purpose.  It is provided "as is" without express or implied warranty.
  */
 
-/** @file stl_heap.h
+/** @file bits/stl_heap.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{queue}
  */
 
 #ifndef _STL_HEAP_H
index e930ddb..4de1b0e 100644 (file)
@@ -49,9 +49,9 @@
  * purpose.  It is provided "as is" without express or implied warranty.
  */
 
-/** @file stl_iterator.h
+/** @file bits/stl_iterator.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{iterator}
  *
  *  This file implements reverse_iterator, back_insert_iterator,
  *  front_insert_iterator, insert_iterator, __normal_iterator, and their
index f885ae6..aa7b348 100644 (file)
@@ -49,9 +49,9 @@
  * purpose.  It is provided "as is" without express or implied warranty.
  */
 
-/** @file stl_iterator_base_funcs.h
+/** @file bits/stl_iterator_base_funcs.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{iterator}
  *
  *  This file contains all of the general iterator-related utility
  *  functions, such as distance() and advance().
index 7b1eafd..4125272 100644 (file)
@@ -49,9 +49,9 @@
  * purpose.  It is provided "as is" without express or implied warranty.
  */
 
-/** @file stl_iterator_base_types.h
+/** @file bits/stl_iterator_base_types.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{iterator}
  *
  *  This file contains all of the general iterator-related utility types,
  *  such as iterator_traits and struct iterator.
index 2bbb26f..aafd5dc 100644 (file)
@@ -49,9 +49,9 @@
  * purpose.  It is provided "as is" without express or implied warranty.
  */
 
-/** @file stl_list.h
+/** @file bits/stl_list.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{list}
  */
 
 #ifndef _STL_LIST_H
index 8add2a4..d3bab26 100644 (file)
@@ -49,9 +49,9 @@
  * purpose.  It is provided "as is" without express or implied warranty.
  */
 
-/** @file stl_map.h
+/** @file bits/stl_map.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{map}
  */
 
 #ifndef _STL_MAP_H
index ec0c9a0..6c6f356 100644 (file)
@@ -49,9 +49,9 @@
  * purpose.  It is provided "as is" without express or implied warranty.
  */
 
-/** @file stl_multimap.h
+/** @file bits/stl_multimap.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{map}
  */
 
 #ifndef _STL_MULTIMAP_H
index 58f902c..62e82dc 100644 (file)
@@ -49,9 +49,9 @@
  * purpose.  It is provided "as is" without express or implied warranty.
  */
 
-/** @file stl_multiset.h
+/** @file bits/stl_multiset.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{set}
  */
 
 #ifndef _STL_MULTISET_H
index 1adddf6..925e064 100644 (file)
@@ -49,9 +49,9 @@
  * purpose.  It is provided "as is" without express or implied warranty.
  */
 
-/** @file stl_numeric.h
+/** @file bits/stl_numeric.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{numeric}
  */
 
 #ifndef _STL_NUMERIC_H
index c6753f6..5334e1a 100644 (file)
@@ -49,9 +49,9 @@
  * purpose.  It is provided "as is" without express or implied warranty.
  */
 
-/** @file stl_pair.h
+/** @file bits/stl_pair.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{utility}
  */
 
 #ifndef _STL_PAIR_H
@@ -72,7 +72,7 @@ _GLIBCXX_BEGIN_NAMESPACE(std)
   /// piecewise_construct
   constexpr piecewise_construct_t piecewise_construct = piecewise_construct_t();
 
-  // forward declarations
+  // Forward declarations.
   template<typename...>
     class tuple;
 
@@ -80,15 +80,15 @@ _GLIBCXX_BEGIN_NAMESPACE(std)
     struct _Index_tuple;
 #endif
 
-  /// pair holds two objects of arbitrary type.
+  /// Struct holding two objects of arbitrary type.
   template<class _T1, class _T2>
     struct pair
     {
-      typedef _T1 first_type;    /// @c first_type is the first bound type
-      typedef _T2 second_type;   /// @c second_type is the second bound type
+      typedef _T1 first_type;    /// @c first_type is the first bound type
+      typedef _T2 second_type;   /// @c second_type is the second bound type
 
-      _T1 first;                 ///< @c first is a copy of the first object
-      _T2 second;                ///< @c second is a copy of the second object
+      _T1 first;                 /// @c first is a copy of the first object
+      _T2 second;                /// @c second is a copy of the second object
 
       // _GLIBCXX_RESOLVE_LIB_DEFECTS
       // 265.  std::pair::pair() effects overly restrictive
index 85a06ab..fa40245 100644 (file)
@@ -49,9 +49,9 @@
  * purpose.  It is provided "as is" without express or implied warranty.
  */
 
-/** @file stl_queue.h
+/** @file bits/stl_queue.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{queue}
  */
 
 #ifndef _STL_QUEUE_H
index 254aa85..29374c7 100644 (file)
@@ -49,9 +49,9 @@
  * purpose.  It is provided "as is" without express or implied warranty.
  */
 
-/** @file stl_raw_storage_iter.h
+/** @file bits/stl_raw_storage_iter.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{memory}
  */
 
 #ifndef _STL_RAW_STORAGE_ITERATOR_H
index 4377c5f..10e4170 100644 (file)
@@ -48,9 +48,9 @@
  *
  */
 
-/** @file stl_relops.h
+/** @file bits/stl_relops.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{utility}
  *
  *  Inclusion of this file has been removed from
  *  all of the other STL headers for safety reasons, except std_utility.h.
@@ -58,7 +58,7 @@
  *  with http://gcc.gnu.org/ml/libstdc++/2001-01/msg00223.html, or
  *  http://gcc.gnu.org/onlinedocs/libstdc++/faq.html#faq.ambiguous_overloads
  *
- *  Short summary:  the rel_ops operators should be avoided for the present.
+ *  Short summary: the rel_ops operators should be avoided for the present.
  */
 
 #ifndef _STL_RELOPS_H
index 8d82716..243de96 100644 (file)
@@ -49,9 +49,9 @@
  * purpose.  It is provided "as is" without express or implied warranty.
  */
 
-/** @file stl_set.h
+/** @file bits/stl_set.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{set}
  */
 
 #ifndef _STL_SET_H
index 7312a35..a5c25d4 100644 (file)
@@ -49,9 +49,9 @@
  * purpose.  It is provided "as is" without express or implied warranty.
  */
 
-/** @file stl_stack.h
+/** @file bits/stl_stack.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{stack}
  */
 
 #ifndef _STL_STACK_H
index 4757117..44dcbf5 100644 (file)
@@ -49,9 +49,9 @@
  * purpose.  It is provided "as is" without express or implied warranty.
  */
 
-/** @file stl_tempbuf.h
+/** @file bits/stl_tempbuf.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{memory}
  */
 
 #ifndef _STL_TEMPBUF_H
index 8919030..80246dc 100644 (file)
@@ -52,9 +52,9 @@
  *
  */
 
-/** @file stl_tree.h
+/** @file bits/stl_tree.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{map or set}
  */
 
 #ifndef _STL_TREE_H
index c5cbde0..fd9f243 100644 (file)
@@ -50,9 +50,9 @@
  * purpose.  It is provided "as is" without express or implied warranty.
  */
 
-/** @file stl_uninitialized.h
+/** @file bits/stl_uninitialized.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{memory}
  */
 
 #ifndef _STL_UNINITIALIZED_H
index 147e3f7..feabb24 100644 (file)
@@ -49,9 +49,9 @@
  * purpose.  It is provided "as is" without express or implied warranty.
  */
 
-/** @file stl_vector.h
+/** @file bits/stl_vector.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{vector}
  */
 
 #ifndef _STL_VECTOR_H
index a5675cb..9d3b799 100644 (file)
@@ -22,9 +22,9 @@
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file stream_iterator.h
+/** @file bits/stream_iterator.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{iterator}
  */
 
 #ifndef _STREAM_ITERATOR_H
index f3e6ce7..8d401b3 100644 (file)
@@ -23,9 +23,9 @@
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file streambuf.tcc
+/** @file bits/streambuf.tcc
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{streambuf}
  */
 
 //
index 3ec1df1..c385ec6 100644 (file)
@@ -24,9 +24,9 @@
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file streambuf_iterator.h
+/** @file bits/streambuf_iterator.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{iterator}
  */
 
 #ifndef _STREAMBUF_ITERATOR_H
index 5679be7..796200a 100644 (file)
@@ -24,9 +24,9 @@
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file stringfwd.h
+/** @file bits/stringfwd.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{string}
  */
 
 //
@@ -60,12 +60,12 @@ _GLIBCXX_BEGIN_NAMESPACE(std)
 
   template<> struct char_traits<char>;
 
-  typedef basic_string<char>    string;   ///< A string of @c char
+  typedef basic_string<char>    string;   /// A string of @c char
 
 #ifdef _GLIBCXX_USE_WCHAR_T
   template<> struct char_traits<wchar_t>;
 
-  typedef basic_string<wchar_t> wstring;   ///< A string of @c wchar_t
+  typedef basic_string<wchar_t> wstring;   /// A string of @c wchar_t
 #endif
 
 #if (defined(__GXX_EXPERIMENTAL_CXX0X__) \
@@ -74,8 +74,8 @@ _GLIBCXX_BEGIN_NAMESPACE(std)
   template<> struct char_traits<char16_t>;
   template<> struct char_traits<char32_t>;
 
-  typedef basic_string<char16_t> u16string; ///< A string of @c char16_t
-  typedef basic_string<char32_t> u32string; ///< A string of @c char32_t
+  typedef basic_string<char16_t> u16string; /// A string of @c char16_t
+  typedef basic_string<char32_t> u32string; /// A string of @c char32_t
 
 #endif
   /** @}  */
index 7436798..0b00fcb 100644 (file)
@@ -22,9 +22,9 @@
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file unique_ptr.h
+/** @file bits/unique_ptr.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{memory}
  */
 
 #ifndef _UNIQUE_PTR_H
index 08058c1..3960f8e 100644 (file)
@@ -24,7 +24,7 @@
 
 /** @file bits/unordered_map.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{unordered_map}
  */
 
 #ifndef _UNORDERED_MAP_H
index 260ad79..90b30f0 100644 (file)
@@ -24,7 +24,7 @@
 
 /** @file bits/unordered_set.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{unordered_set}
  */
 
 #ifndef _UNORDERED_SET_H
index 070840e..1206655 100644 (file)
@@ -23,9 +23,9 @@
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file valarray_after.h
+/** @file bits/valarray_after.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{valarray}
  */
 
 // Written by Gabriel Dos Reis <Gabriel.Dos-Reis@cmla.ens-cachan.fr>
index 7aa61f1..ae148ef 100644 (file)
@@ -24,9 +24,9 @@
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file valarray_array.h
+/** @file bits/valarray_array.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{valarray}
  */
 
 // Written by Gabriel Dos Reis <Gabriel.Dos-Reis@DPTMaths.ENS-Cachan.Fr>
index 15cb7b1..9a13479 100644 (file)
@@ -22,9 +22,9 @@
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file valarray_array.tcc
+/** @file bits/valarray_array.tcc
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{valarray}
  */
 
 // Written by Gabriel Dos Reis <Gabriel.Dos-Reis@DPTMaths.ENS-Cachan.Fr>
index 3bc85a3..b7efefe 100644 (file)
@@ -23,9 +23,9 @@
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file valarray_before.h
+/** @file bits/valarray_before.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{valarray}
  */
 
 // Written by Gabriel Dos Reis <Gabriel.Dos-Reis@cmla.ens-cachan.fr>
index ffe4bb8..bc10b92 100644 (file)
@@ -49,9 +49,9 @@
  * purpose.  It is provided "as is" without express or implied warranty.
  */
 
-/** @file vector.tcc
+/** @file bits/vector.tcc
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{vector}
  */
 
 #ifndef _VECTOR_TCC
index 8ef5a91..241bcec 100644 (file)
@@ -21,7 +21,7 @@
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file include/decimal/decimal
+/** @file decimal/decimal
  *  This is a Standard C++ Library header.
  */
 
index 5cb419e..c853e84 100644 (file)
@@ -22,9 +22,8 @@
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file atomicity.h
- *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+/** @file ext/atomicity.h
+ *  This file is a GNU extension to the Standard C++ Library.
  */
 
 #ifndef _GLIBCXX_ATOMICITY_H
index 8fd8cc9..f58c0fc 100644 (file)
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-#ifndef _CAST_H
-#define _CAST_H 1
+/** @file ext/cast.h
+ *  This is an internal header file, included by other library headers.
+ *  Do not attempt to use it directly. @headername{ext/pointer.h}
+ */
+
+#ifndef _GLIBCXX_CAST_H
+#define _GLIBCXX_CAST_H 1
 
 _GLIBCXX_BEGIN_NAMESPACE(__gnu_cxx)
 
@@ -110,4 +115,4 @@ _GLIBCXX_BEGIN_NAMESPACE(__gnu_cxx)
 
 _GLIBCXX_END_NAMESPACE
 
-#endif // _CAST_H
+#endif // __GLIBCXX_CAST_H
index b665b41..b6f86a4 100644 (file)
@@ -23,9 +23,8 @@
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
-/** @file concurrence.h
- *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+/** @file ext/concurrence.h
+ *  This file is a GNU extension to the Standard C++ Library.
  */
 
 #ifndef _CONCURRENCE_H
index 18d8049..d084d74 100644 (file)
@@ -37,7 +37,6 @@
 
 /** @file ext/debug_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 _DEBUG_ALLOCATOR_H
index d9e8cda..d3caf8a 100644 (file)
 // <http://www.gnu.org/licenses/>.
 
 /**
- * @file ext/extptr_allocator.h
- * @author Bob Walters
+ *  @file ext/extptr_allocator.h
+ *  This file is a GNU extension to the Standard C++ Library.
+ *
+ *  @author Bob Walters
  *
  * An example allocator which uses an alternative pointer type from
  * bits/pointer.h.  Supports test cases which confirm container support
index 8055df2..692a1c8 100644 (file)
 // <http://www.gnu.org/licenses/>.
 
 /**
- * @file ext/pointer.h
- * @author Bob Walters
+ *  @file ext/pointer.h
+ *  This file is a GNU extension to the Standard C++ Library.
+ *
+ *  @author Bob Walters
  *
  * Provides reusable _Pointer_adapter for assisting in the development of
  * custom pointer types that can be used with the standard containers via
index 9831037..b4037d6 100644 (file)
@@ -24,9 +24,8 @@
 // <http://www.gnu.org/licenses/>.
 
 /** @file ext/rc_string_base.h
- *  This file is a GNU extension to the Standard C++ Library.
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{ext/vstring.h}
  */
 
 #ifndef _RC_STRING_BASE_H
@@ -115,7 +114,7 @@ _GLIBCXX_BEGIN_NAMESPACE(__gnu_cxx)
            size_type       _M_capacity;
            _Atomic_word    _M_refcount;
          }                 _M_info;
-         
+
          // Only for alignment purposes.
          _CharT            _M_align;
        };
@@ -132,10 +131,10 @@ _GLIBCXX_BEGIN_NAMESPACE(__gnu_cxx)
          __atomic_add_dispatch(&_M_info._M_refcount, 1);
          return _M_refdata();
        }  // XXX MT
-       
+
        void
        _M_set_length(size_type __n)
-       { 
+       {
          _M_info._M_refcount = 0;  // One reference.
          _M_info._M_length = __n;
          // grrr. (per 21.3.4)
@@ -193,7 +192,7 @@ _GLIBCXX_BEGIN_NAMESPACE(__gnu_cxx)
       _M_grab(const _Alloc& __alloc) const
       {
        return (!_M_is_leaked() && _M_get_allocator() == __alloc)
-               ? _M_rep()->_M_refcopy() : _M_rep()->_M_clone(__alloc);
+               ? _M_rep()->_M_refcopy() : _M_rep()->_M_clone(__alloc);
       }
 
       void
@@ -225,19 +224,19 @@ _GLIBCXX_BEGIN_NAMESPACE(__gnu_cxx)
       // _S_construct_aux is used to implement the 21.3.1 para 15 which
       // requires special behaviour if _InIterator is an integral type
       template<typename _InIterator>
-        static _CharT*
-        _S_construct_aux(_InIterator __beg, _InIterator __end,
+       static _CharT*
+       _S_construct_aux(_InIterator __beg, _InIterator __end,
                         const _Alloc& __a, std::__false_type)
        {
-          typedef typename iterator_traits<_InIterator>::iterator_category _Tag;
-          return _S_construct(__beg, __end, __a, _Tag());
+         typedef typename iterator_traits<_InIterator>::iterator_category _Tag;
+         return _S_construct(__beg, __end, __a, _Tag());
        }
 
       // _GLIBCXX_RESOLVE_LIB_DEFECTS
       // 438. Ambiguity in the "do the right thing" clause
       template<typename _Integer>
-        static _CharT*
-        _S_construct_aux(_Integer __beg, _Integer __end,
+       static _CharT*
+       _S_construct_aux(_Integer __beg, _Integer __end,
                         const _Alloc& __a, std::__true_type)
        { return _S_construct_aux_2(static_cast<size_type>(__beg),
                                    __end, __a); }
@@ -247,24 +246,24 @@ _GLIBCXX_BEGIN_NAMESPACE(__gnu_cxx)
       { return _S_construct(__req, __c, __a); }
 
       template<typename _InIterator>
-        static _CharT*
-        _S_construct(_InIterator __beg, _InIterator __end, const _Alloc& __a)
+       static _CharT*
+       _S_construct(_InIterator __beg, _InIterator __end, const _Alloc& __a)
        {
          typedef typename std::__is_integer<_InIterator>::__type _Integral;
          return _S_construct_aux(__beg, __end, __a, _Integral());
-        }
+       }
 
       // For Input Iterators, used in istreambuf_iterators, etc.
       template<typename _InIterator>
-        static _CharT*
-         _S_construct(_InIterator __beg, _InIterator __end, const _Alloc& __a,
+       static _CharT*
+        _S_construct(_InIterator __beg, _InIterator __end, const _Alloc& __a,
                      std::input_iterator_tag);
-      
+
       // For forward_iterators up to random_access_iterators, used for
       // string::iterator, _CharT*, etc.
       template<typename _FwdIterator>
-        static _CharT*
-        _S_construct(_FwdIterator __beg, _FwdIterator __end, const _Alloc& __a,
+       static _CharT*
+       _S_construct(_FwdIterator __beg, _FwdIterator __end, const _Alloc& __a,
                     std::forward_iterator_tag);
 
       static _CharT*
@@ -322,11 +321,11 @@ _GLIBCXX_BEGIN_NAMESPACE(__gnu_cxx)
       __rc_string_base(size_type __n, _CharT __c, const _Alloc& __a);
 
       template<typename _InputIterator>
-        __rc_string_base(_InputIterator __beg, _InputIterator __end,
+       __rc_string_base(_InputIterator __beg, _InputIterator __end,
                         const _Alloc& __a);
 
       ~__rc_string_base()
-      { _M_dispose(); }      
+      { _M_dispose(); }
 
       allocator_type&
       _M_get_allocator()
@@ -348,7 +347,7 @@ _GLIBCXX_BEGIN_NAMESPACE(__gnu_cxx)
       void
       _M_mutate(size_type __pos, size_type __len1, const _CharT* __s,
                size_type __len2);
-      
+
       void
       _M_erase(size_type __pos, size_type __n);
 
@@ -604,7 +603,7 @@ _GLIBCXX_BEGIN_NAMESPACE(__gnu_cxx)
        _M_set_sharable();
       if (__rcs._M_is_leaked())
        __rcs._M_set_sharable();
-      
+
       _CharT* __tmp = _M_data();
       _M_data(__rcs._M_data());
       __rcs._M_data(__tmp);
@@ -613,7 +612,7 @@ _GLIBCXX_BEGIN_NAMESPACE(__gnu_cxx)
       // 431. Swapping containers with unequal allocators.
       std::__alloc_swap<allocator_type>::_S_do_it(_M_get_allocator(),
                                                  __rcs._M_get_allocator());
-    } 
+    }
 
   template<typename _CharT, typename _Traits, typename _Alloc>
     void
@@ -636,7 +635,7 @@ _GLIBCXX_BEGIN_NAMESPACE(__gnu_cxx)
       // Make sure we don't shrink below the current size.
       if (__res < _M_length())
        __res = _M_length();
-      
+
       if (__res != _M_capacity() || _M_is_shared())
        {
          _CharT* __tmp = _M_rep()->_M_clone(_M_get_allocator(),
@@ -653,10 +652,10 @@ _GLIBCXX_BEGIN_NAMESPACE(__gnu_cxx)
              size_type __len2)
     {
       const size_type __how_much = _M_length() - __pos - __len1;
-      
+
       _Rep* __r = _Rep::_S_create(_M_length() + __len2 - __len1,
                                  _M_capacity(), _M_get_allocator());
-      
+
       if (__pos)
        _S_copy(__r->_M_refdata(), _M_data(), __pos);
       if (__s && __len2)
@@ -664,7 +663,7 @@ _GLIBCXX_BEGIN_NAMESPACE(__gnu_cxx)
       if (__how_much)
        _S_copy(__r->_M_refdata() + __pos + __len2,
                _M_data() + __pos + __len1, __how_much);
-      
+
       _M_dispose();
       _M_data(__r->_M_refdata());
     }
@@ -676,7 +675,7 @@ _GLIBCXX_BEGIN_NAMESPACE(__gnu_cxx)
     {
       const size_type __new_size = _M_length() - __n;
       const size_type __how_much = _M_length() - __pos - __n;
-      
+
       if (_M_is_shared())
        {
          // Must reallocate.
@@ -699,7 +698,7 @@ _GLIBCXX_BEGIN_NAMESPACE(__gnu_cxx)
                  _M_data() + __pos + __n, __how_much);
        }
 
-      _M_rep()->_M_set_length(__new_size);      
+      _M_rep()->_M_set_length(__new_size);
     }
 
   template<>
index e79bca4..75d3e86 100644 (file)
@@ -38,7 +38,7 @@
 
 /** @file ropeimpl.h
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{ext/rope}
  */
 
 #include <cstdio>
index 6168631..4899e1f 100644 (file)
@@ -24,9 +24,8 @@
 // <http://www.gnu.org/licenses/>.
 
 /** @file ext/sso_string_base.h
- *  This file is a GNU extension to the Standard C++ Library.
  *  This is an internal header file, included by other library headers.
- *  You should not attempt to use it directly.
+ *  Do not attempt to use it directly. @headername{ext/vstring.h}
  */
 
 #ifndef _SSO_STRING_BASE_H
index a4276f3..196295c 100644 (file)
 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
 // <http://www.gnu.org/licenses/>.
 
+/** @file ext/string_conversions.h
+ *  This file is a GNU extension to the Standard C++ Library.
+ */
+
 #ifndef _STRING_CONVERSIONS_H
 #define _STRING_CONVERSIONS_H 1
 
index ff1cac7..2fe6f61 100644 (file)
 // purpose. It is provided "as is" without express or implied warranty.
 
 /**
- * @file typelist.h
- * Contains typelist_chain definitions.
- * Typelists are an idea by Andrei Alexandrescu.
+ *  @file ext/typelist.h
+ *  This file is a GNU extension to the Standard C++ Library.
+ *
+ *  Contains typelist_chain definitions.
+ *  Typelists are an idea by Andrei Alexandrescu.
  */
 
 #ifndef _TYPELIST_H
@@ -89,7 +91,7 @@ namespace typelist
 
   template<typename Typelist, typename T>
     struct contains;
+
   template<typename Typelist, template<typename T> class Pred>
     struct filter;
 
@@ -120,7 +122,7 @@ namespace typelist
   template<typename T1, typename T2, typename T3, typename T4, typename T5>
     struct create5;
 
-  template<typename T1, typename T2, typename T3, 
+  template<typename T1, typename T2, typename T3,
           typename T4, typename T5, typename T6>
     struct create6;
 } // namespace typelist
@@ -130,7 +132,7 @@ _GLIBCXX_END_NAMESPACE
 
 _GLIBCXX_BEGIN_NAMESPACE(__gnu_cxx)
 
-namespace typelist 
+namespace typelist
 {
 namespace detail
 {
@@ -245,7 +247,7 @@ namespace detail
     {
     private:
       typedef typename append_typelist_<Tl>::type              rest_type;
-      
+
     public:
       typedef typename append<Hd, node<rest_type> >::type::root        type;
     };
@@ -270,7 +272,7 @@ namespace detail
          value = contains_<Tl, T>::value
        };
     };
-  
+
   template<typename Tl, typename T>
     struct contains_<chain<T, Tl>, T>
     {
@@ -297,7 +299,7 @@ namespace detail
        {
          include_hd = Pred<Hd>::value
        };
-      
+
       typedef typename chain_filter_<Tl, Pred>::type           rest_type;
       typedef chain<Hd, rest_type>                             chain_type;
 
@@ -313,7 +315,7 @@ namespace detail
     {
       typedef Hd                                               type;
     };
-  
+
   template<typename Hd, typename Tl, int i>
     struct chain_at_index_<chain<Hd, Tl>, i>
     {
@@ -328,7 +330,7 @@ namespace detail
     {
       typedef null_type                                        type;
     };
-  
+
   template<class Hd, class Tl, template<typename T> class Transform>
     struct chain_transform_<chain<Hd, Tl>, Transform>
     {
@@ -462,7 +464,7 @@ namespace typelist
     private: