[libstdc++] Minor cleanups

Phil Edwards phil@jaj.com
Sun Jun 2 21:46:00 GMT 2002


Little things accumulated over the past month, mostly comment changes.


2002-06-03  Phil Edwards  <pme@gcc.gnu.org>

	* docs/doxygen/TODO:  Update.
	* docs/doxygen/user.cfg.in (SORT_MEMBER_DOCS):  Set to off, now that
	some class members are in 14882 order.
	* docs/html/ext/howto.html:  3.1 is in the past now, not the future.

	* include/std/std_bitset.h:  Update comment.
	* src/bitset.cc:  Update comments, clean up spacing.

	* src/Makefile.am (sources):  Alphabetize for convenience.
	* src/Makefile.in:  Regenerate.


Index: docs/doxygen/TODO
===================================================================
RCS file: /cvs/gcc/gcc/libstdc++-v3/docs/doxygen/TODO,v
retrieving revision 1.7
diff -u -3 -p -r1.7 TODO
--- docs/doxygen/TODO	27 Mar 2002 21:41:29 -0000	1.7
+++ docs/doxygen/TODO	3 Jun 2002 04:41:55 -0000
@@ -24,7 +24,8 @@ c19             Note A
 c20             Note A
 c21             Untouched, Note B
 c22             Untouched
-c23             See doxygroups.cc and Note B.
+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)
Index: docs/doxygen/user.cfg.in
===================================================================
RCS file: /cvs/gcc/gcc/libstdc++-v3/docs/doxygen/user.cfg.in,v
retrieving revision 1.18
diff -u -3 -p -r1.18 user.cfg.in
--- docs/doxygen/user.cfg.in	21 May 2002 20:45:00 -0000	1.18
+++ docs/doxygen/user.cfg.in	3 Jun 2002 04:41:55 -0000
@@ -183,7 +183,7 @@ INLINE_INFO            = YES
 # alphabetically by member name. If set to NO the members will appear in 
 # declaration order.
 
-SORT_MEMBER_DOCS       = YES
+SORT_MEMBER_DOCS       = NO
 
 # If member grouping is used in the documentation and the DISTRIBUTE_GROUP_DOC 
 # tag is set to YES, then doxygen will reuse the documentation of the first 
Index: docs/html/ext/howto.html
===================================================================
RCS file: /cvs/gcc/gcc/libstdc++-v3/docs/html/ext/howto.html,v
retrieving revision 1.19
diff -u -3 -p -r1.19 howto.html
--- docs/html/ext/howto.html	1 May 2002 22:57:59 -0000	1.19
+++ docs/html/ext/howto.html	3 Jun 2002 04:41:55 -0000
@@ -219,8 +219,8 @@
    <p>Well then:
    </p>
    <h3>Available allocators in namespace std</h3>
-   <p>First I'll describe the situation as it exists for the code which will
-      be released in GCC 3.1.  This situation is extremely fluid.  Then I'll
+   <p>First I'll describe the situation as it exists for the code which
+      was released in GCC 3.1.  Then I'll
       describe the differences for 3.0.x, which will not change much in
       this respect.
    </p>
Index: include/std/std_bitset.h
===================================================================
RCS file: /cvs/gcc/gcc/libstdc++-v3/include/std/std_bitset.h,v
retrieving revision 1.7
diff -u -3 -p -r1.7 std_bitset.h
--- include/std/std_bitset.h	24 May 2002 18:15:56 -0000	1.7
+++ include/std/std_bitset.h	3 Jun 2002 04:41:55 -0000
@@ -578,7 +578,7 @@ namespace std
    *  (Note that %bitset does @e not meet the formal requirements of a
    *  <a href="tables.html#65">container</a>.  Mainly, it lacks iterators.)
    *
-   *  The template argument, @a _Nb, may be any nonzero number of type
+   *  The template argument, @a _Nb, may be any non-negative number of type
    *  size_t.
    *
    *  A %bitset of size N has N % (sizeof(unsigned long) * CHAR_BIT) unused
Index: src/Makefile.am
===================================================================
RCS file: /cvs/gcc/gcc/libstdc++-v3/src/Makefile.am,v
retrieving revision 1.106
diff -u -3 -p -r1.106 Makefile.am
--- src/Makefile.am	27 May 2002 14:55:50 -0000	1.106
+++ src/Makefile.am	3 Jun 2002 04:41:55 -0000
@@ -61,16 +61,42 @@ INCLUDES = \
 	$(TOPLEVEL_INCLUDES)
 
 sources = \
-	globals.cc limits.cc \
-	basic_file.cc complex_io.cc ios.cc strstream.cc \
-	cmath.cc bitset.cc \
-	functexcept.cc stdexcept.cc vterminate.cc \
-	c++locale.cc locale.cc localename.cc codecvt.cc \
-	collate.cc ctype.cc messages.cc monetary.cc numeric.cc time.cc \
-	concept-inst.cc locale-inst.cc misc-inst.cc stl-inst.cc \
-	string-inst.cc wstring-inst.cc valarray-inst.cc  ext-inst.cc \
-	fstream-inst.cc io-inst.cc istream-inst.cc ostream-inst.cc \
-	streambuf-inst.cc sstream-inst.cc
+	basic_file.cc \
+	bitset.cc \
+	c++locale.cc \
+	cmath.cc \
+	codecvt.cc \
+	collate.cc \
+	complex_io.cc \
+	concept-inst.cc \
+	ctype.cc \
+	ext-inst.cc \
+	fstream-inst.cc \
+	functexcept.cc \
+	globals.cc \
+	io-inst.cc \
+	ios.cc \
+	istream-inst.cc \
+	limits.cc \
+	locale-inst.cc \
+	locale.cc \
+	localename.cc \
+	messages.cc \
+	misc-inst.cc \
+	monetary.cc \
+	numeric.cc \
+	ostream-inst.cc \
+	sstream-inst.cc \
+	stdexcept.cc \
+	stl-inst.cc \
+	streambuf-inst.cc \
+	string-inst.cc \
+	strstream.cc \
+	time.cc \
+	valarray-inst.cc \
+	vterminate.cc \
+	wstring-inst.cc
+
 
 VPATH = $(top_srcdir)/src:$(top_srcdir)
 
Index: src/bitset.cc
===================================================================
RCS file: /cvs/gcc/gcc/libstdc++-v3/src/bitset.cc,v
retrieving revision 1.8
diff -u -3 -p -r1.8 bitset.cc
--- src/bitset.cc	9 Apr 2002 07:35:30 -0000	1.8
+++ src/bitset.cc	3 Jun 2002 04:41:55 -0000
@@ -8,12 +8,12 @@
 // it under the terms of the GNU General Public License as published by
 // the Free Software Foundation; either version 2, or (at your option)
 // any later version.
-// 
+//
 // GNU CC is distributed in the hope that it will be useful,
 // but WITHOUT ANY WARRANTY; without even the implied warranty of
 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 // GNU General Public License for more details.
-// 
+//
 // You should have received a copy of the GNU General Public License
 // along with GNU CC; see the file COPYING.  If not, write to
 // the Free Software Foundation, 59 Temple Place - Suite 330,
@@ -39,7 +39,7 @@
  * in supporting documentation.  Silicon Graphics makes no
  * representations about the suitability of this software for any
  * purpose.  It is provided "as is" without express or implied warranty.
- */ 
+ */
 
 #include <bitset>
 
@@ -69,7 +69,7 @@ std::_Base_bitset<1>::_M_do_find_first(s
 }
 
 std::size_t
-std::_Base_bitset<1>::_M_do_find_next(std::size_t __prev, 
+std::_Base_bitset<1>::_M_do_find_next(std::size_t __prev,
 				      std::size_t __not_found) const
 {
   // make bound inclusive
@@ -104,8 +104,9 @@ std::_Base_bitset<1>::_M_do_find_next(st
 } // end _M_do_find_next
 
 
-// Lookup tables for find and count operations.
-unsigned char std::_S_bit_count[256] = 
+// Lookup tables for find and count operations.  In _S_bit_count, the value
+// *at* an index is the number of bits set *in* that index.
+unsigned char std::_S_bit_count[256] =
 {
   0, /*   0 */ 1, /*   1 */ 1, /*   2 */ 2, /*   3 */ 1, /*   4 */
   2, /*   5 */ 2, /*   6 */ 3, /*   7 */ 1, /*   8 */ 2, /*   9 */
@@ -161,7 +162,7 @@ unsigned char std::_S_bit_count[256] = 
   8  /* 255 */
 }; // end _S_bit_count
 
-unsigned char std::_S_first_one[256] = 
+unsigned char std::_S_first_one[256] =
 {
   0, /*   0 */ 0, /*   1 */ 1, /*   2 */ 0, /*   3 */ 2, /*   4 */
   0, /*   5 */ 1, /*   6 */ 0, /*   7 */ 3, /*   8 */ 0, /*   9 */



More information about the Libstdc++ mailing list