From fc7f0a806cd0ade2c93bebca3f97ea5ee5eedcc2 Mon Sep 17 00:00:00 2001 From: Phil Edwards Date: Tue, 2 Jul 2002 06:17:36 +0000 Subject: [PATCH] configopts.html, [...]: Tweaks. 2002-07-02 Phil Edwards * docs/html/configopts.html, docs/html/install.html: Tweaks. * include/ext/algorithm, include/ext/hash_map, include/ext/hash_set, include/ext/iterator, include/ext/numeric, include/ext/rb_tree, include/ext/slist, include/ext/stl_rope.h: Add doxygen hooks. From-SVN: r55172 --- libstdc++-v3/ChangeLog | 7 +++++ libstdc++-v3/docs/html/configopts.html | 11 ++++--- libstdc++-v3/docs/html/install.html | 36 +++++++++++------------ libstdc++-v3/include/ext/algorithm | 40 ++++++++++++++++++++++++++ libstdc++-v3/include/ext/hash_map | 11 ++++++- libstdc++-v3/include/ext/hash_set | 10 +++++++ libstdc++-v3/include/ext/iterator | 5 ++++ libstdc++-v3/include/ext/numeric | 15 ++++++++++ libstdc++-v3/include/ext/rb_tree | 5 ++++ libstdc++-v3/include/ext/slist | 5 ++++ libstdc++-v3/include/ext/stl_rope.h | 5 ++++ 11 files changed, 125 insertions(+), 25 deletions(-) diff --git a/libstdc++-v3/ChangeLog b/libstdc++-v3/ChangeLog index baa71d429db6..2999d1048edb 100644 --- a/libstdc++-v3/ChangeLog +++ b/libstdc++-v3/ChangeLog @@ -1,3 +1,10 @@ +2002-07-02 Phil Edwards + + * docs/html/configopts.html, docs/html/install.html: Tweaks. + * include/ext/algorithm, include/ext/hash_map, include/ext/hash_set, + include/ext/iterator, include/ext/numeric, include/ext/rb_tree, + include/ext/slist, include/ext/stl_rope.h: Add doxygen hooks. + 2002-07-01 Benjamin Kosnik * include/backward/strstream: Remove namespace std. Transfer to... diff --git a/libstdc++-v3/docs/html/configopts.html b/libstdc++-v3/docs/html/configopts.html index 27f3c49404e0..204aba511361 100644 --- a/libstdc++-v3/docs/html/configopts.html +++ b/libstdc++-v3/docs/html/configopts.html @@ -26,7 +26,7 @@ options

Here are some of the non-obvious options to libstdc++'s configure. Keep in mind that - they + they all have opposite forms as well (enable/disable and with/without). The defaults are for current development sources. @@ -46,14 +46,13 @@ options

--enable-debug

The configure script will automatically detect the highest - level of optimization that the compiler in use can use - (certain versions of g++ will ICE if given the -O2 - option, but this is fixed in later versions of the compiler). + level of optimization that the compiler in use can use. This --enable flag will disable all optimizations and instruct the compiler to emit as much extra debugging information as it - can, for use inside GDB. Note this make command, executed in + can, for use inside GDB. Note this make command, executed in the build directory, will do much the same thing, without the - configuration difference:make CXXFLAGS='-g -O0' all + configuration difference: + make CXXFLAGS='-g -O0' all

--enable-cstdio diff --git a/libstdc++-v3/docs/html/install.html b/libstdc++-v3/docs/html/install.html index ff351049b98f..a76a932d92e1 100644 --- a/libstdc++-v3/docs/html/install.html +++ b/libstdc++-v3/docs/html/install.html @@ -73,7 +73,7 @@ with C++ exception handling related to this change in libstdc++-v3). The version of these tools should be 2.10.90, or later, and you can get snapshots (as - well as releases) of binutils + well as releases) of binutils here. The configure process will automatically detect and use these features if the underlying support is present. @@ -87,7 +87,7 @@ configure process will automatically detect and use these features if the underlying support is present.

- +

Finally, a few system-specific requirements:

linux @@ -103,22 +103,22 @@ named locale tests. If this isn't an issue, don't worry about it. If named locales are needed, the underlying locale information must be installed. Note that rebuilding libstdc++ - after locales are installed is not necessary. - -

To install + after locales are installed is not necessary. + +

To install support for locales, do only one of the following:

-

  • install all locales -

    export LC_ALL=C

    -

    rpm -e glibc-common --nodeps

    -

    rpm -i --define "_install_langs all" - glibc-common-2.2.5-34.i386.rpm

    -
    • -
  • install just the necessary locales -

    localedef -i de_DE -f ISO-8859-1 de_DE

    -
    • +
  • install all locales +

    export LC_ALL=C

    +

    rpm -e glibc-common --nodeps

    +

    rpm -i --define "_install_langs all" + glibc-common-2.2.5-34.i386.rpm

    +
    • +
  • install just the necessary locales +

    localedef -i de_DE -f ISO-8859-1 de_DE

    +

    • - +

    @@ -131,7 +131,7 @@
    • gccsrcdir: The directory holding the source of the compiler. It should have several subdirectories like - gccsrcdir/libio and gccsrcdir/gcc. + gccsrcdir/libiberty and gccsrcdir/gcc.
    • libsrcdir: The directory holding the source of the C++ library.
    • gccbuilddir: The build directory for the compiler @@ -216,7 +216,7 @@

      [re]building only libstdc++

      To rebuild just libstdc++, use: 

      -   make all-target-libstdc++-v3
      + make all-target-libstdc++-v3 This will configure and build the C++ library in the gccbuilddir/cpu-vendor-os/libstdc++ directory.

      @@ -232,7 +232,7 @@

      You're done. Now install the rebuilt pieces with 

          make install
      - or + or 
          make install-gcc
    make install-target-libstdc++-v3
      diff --git a/libstdc++-v3/include/ext/algorithm b/libstdc++-v3/include/ext/algorithm index bf72765df931..b35d36f5e422 100644 --- a/libstdc++-v3/include/ext/algorithm +++ b/libstdc++-v3/include/ext/algorithm @@ -247,6 +247,11 @@ namespace __gnu_cxx // random_sample and random_sample_n (extensions, not part of the standard). + /** + * This is an SGI extension. + * @ingroup SGIextensions + * @doctodo + */ template _OutputIter random_sample_n(_ForwardIter __first, _ForwardIter __last, @@ -273,6 +278,11 @@ namespace __gnu_cxx return __out; } + /** + * This is an SGI extension. + * @ingroup SGIextensions + * @doctodo + */ template _OutputIter @@ -353,6 +363,11 @@ namespace __gnu_cxx return __out + __m; } + /** + * This is an SGI extension. + * @ingroup SGIextensions + * @doctodo + */ template inline _RandomAccessIter random_sample(_InputIter __first, _InputIter __last, @@ -367,6 +382,11 @@ namespace __gnu_cxx __out_first, __out_last - __out_first); } + /** + * This is an SGI extension. + * @ingroup SGIextensions + * @doctodo + */ template inline _RandomAccessIter @@ -418,6 +438,11 @@ namespace __gnu_cxx return true; } + /** + * This is an SGI extension. + * @ingroup SGIextensions + * @doctodo + */ template inline bool is_heap(_RandomAccessIter __first, _RandomAccessIter __last) @@ -430,6 +455,11 @@ namespace __gnu_cxx return __is_heap(__first, __last - __first); } + /** + * This is an SGI extension. + * @ingroup SGIextensions + * @doctodo + */ template inline bool is_heap(_RandomAccessIter __first, _RandomAccessIter __last, @@ -448,6 +478,11 @@ namespace __gnu_cxx // nondescending order. This is an extension, not part of the C++ // standard. + /** + * This is an SGI extension. + * @ingroup SGIextensions + * @doctodo + */ template bool is_sorted(_ForwardIter __first, _ForwardIter __last) @@ -469,6 +504,11 @@ namespace __gnu_cxx return true; } + /** + * This is an SGI extension. + * @ingroup SGIextensions + * @doctodo + */ template bool is_sorted(_ForwardIter __first, _ForwardIter __last, _StrictWeakOrdering __comp) diff --git a/libstdc++-v3/include/ext/hash_map b/libstdc++-v3/include/ext/hash_map index 08ed87bf390c..b66758de4462 100644 --- a/libstdc++-v3/include/ext/hash_map +++ b/libstdc++-v3/include/ext/hash_map @@ -83,7 +83,11 @@ class hash_map; template inline bool operator==(const hash_map<_Key, _Tp, _HashFn, _EqKey, _Alloc>&, const hash_map<_Key, _Tp, _HashFn, _EqKey, _Alloc>&); - +/** + * This is an SGI extension. + * @ingroup SGIextensions + * @doctodo +*/ template class hash_map @@ -235,6 +239,11 @@ inline bool operator==(const hash_multimap<_Key,_Tp,_HF,_EqKey,_Alloc>& __hm1, const hash_multimap<_Key,_Tp,_HF,_EqKey,_Alloc>& __hm2); +/** + * This is an SGI extension. + * @ingroup SGIextensions + * @doctodo +*/ template class hash_multimap { diff --git a/libstdc++-v3/include/ext/hash_set b/libstdc++-v3/include/ext/hash_set index eaeed7c99644..0f420e2dd7eb 100644 --- a/libstdc++-v3/include/ext/hash_set +++ b/libstdc++-v3/include/ext/hash_set @@ -85,6 +85,11 @@ inline bool operator==(const hash_set<_Value,_HashFcn,_EqualKey,_Alloc>& __hs1, const hash_set<_Value,_HashFcn,_EqualKey,_Alloc>& __hs2); +/** + * This is an SGI extension. + * @ingroup SGIextensions + * @doctodo +*/ template class hash_set { @@ -236,6 +241,11 @@ operator==(const hash_multiset<_Val,_HashFcn,_EqualKey,_Alloc>& __hs1, const hash_multiset<_Val,_HashFcn,_EqualKey,_Alloc>& __hs2); +/** + * This is an SGI extension. + * @ingroup SGIextensions + * @doctodo +*/ template class hash_multiset { diff --git a/libstdc++-v3/include/ext/iterator b/libstdc++-v3/include/ext/iterator index 3892eb673a8b..f23212f241d6 100644 --- a/libstdc++-v3/include/ext/iterator +++ b/libstdc++-v3/include/ext/iterator @@ -93,6 +93,11 @@ namespace __gnu_cxx __n += __last - __first; } + /** + * This is an SGI extension. + * @ingroup SGIextensions + * @doctodo + */ template inline void distance(_InputIterator __first, _InputIterator __last, diff --git a/libstdc++-v3/include/ext/numeric b/libstdc++-v3/include/ext/numeric index 601cb82bd552..6770461b5c6c 100644 --- a/libstdc++-v3/include/ext/numeric +++ b/libstdc++-v3/include/ext/numeric @@ -105,11 +105,21 @@ namespace __gnu_cxx // Alias for the internal name __power. Note that power is an extension, // not part of the C++ standard. + /** + * This is an SGI extension. + * @ingroup SGIextensions + * @doctodo + */ template inline _Tp power(_Tp __x, _Integer __n, _MonoidOperation __monoid_op) { return __power(__x, __n, __monoid_op); } + /** + * This is an SGI extension. + * @ingroup SGIextensions + * @doctodo + */ template inline _Tp power(_Tp __x, _Integer __n) @@ -117,6 +127,11 @@ namespace __gnu_cxx // iota is not part of the C++ standard. It is an extension. + /** + * This is an SGI extension. + * @ingroup SGIextensions + * @doctodo + */ template void iota(_ForwardIter __first, _ForwardIter __last, _Tp __value) diff --git a/libstdc++-v3/include/ext/rb_tree b/libstdc++-v3/include/ext/rb_tree index f4b24b6fa591..394124383828 100644 --- a/libstdc++-v3/include/ext/rb_tree +++ b/libstdc++-v3/include/ext/rb_tree @@ -73,6 +73,11 @@ using std::allocator; // Class rb_tree is not part of the C++ standard. It is provided for // compatibility with the HP STL. +/** + * This is an SGI extension. + * @ingroup SGIextensions + * @doctodo +*/ template > struct rb_tree : public _Rb_tree<_Key, _Value, _KeyOfValue, _Compare, _Alloc> diff --git a/libstdc++-v3/include/ext/slist b/libstdc++-v3/include/ext/slist index df2e97ba81bb..35e089af5306 100644 --- a/libstdc++-v3/include/ext/slist +++ b/libstdc++-v3/include/ext/slist @@ -295,6 +295,11 @@ _Slist_base<_Tp,_Alloc>::_M_erase_after(_Slist_node_base* __before_first, return __last_node; } +/** + * This is an SGI extension. + * @ingroup SGIextensions + * @doctodo +*/ template > class slist : private _Slist_base<_Tp,_Alloc> { diff --git a/libstdc++-v3/include/ext/stl_rope.h b/libstdc++-v3/include/ext/stl_rope.h index 188fc40d3376..bb9bb47258d1 100644 --- a/libstdc++-v3/include/ext/stl_rope.h +++ b/libstdc++-v3/include/ext/stl_rope.h @@ -1238,6 +1238,11 @@ struct _Rope_base }; +/** + * This is an SGI extension. + * @ingroup SGIextensions + * @doctodo +*/ template class rope : public _Rope_base<_CharT,_Alloc> { public: