This is the mail archive of the gcc-patches@gcc.gnu.org mailing list for the GCC project.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]
Other format: [Raw text]

[libstdc++] Document minimum glibc requirement


Paolo noted that we've been getting some PRs lately resulting from a too-new
libstdc++ being used with a too-old glibc.  This updates the documentation.



2003-02-03  Phil Edwards  <pme@gcc.gnu.org>

	PR libstdc++/9527, PR libstdc++/8713
	* docs/html/install.html:  Mention glibc version requirement.
	* docs/html/faq/index.html (3.8):  New note, glibc 2.2.5+ is needed
	with 3.2.1+ (formatting bugfixes).
	* docs/html/faq/index.txt:  Regenerate.


Index: docs/html/install.html
===================================================================
RCS file: /cvs/gcc/gcc/libstdc++-v3/docs/html/install.html,v
retrieving revision 1.22
diff -u -3 -p -r1.22 install.html
--- docs/html/install.html	13 Nov 2002 01:04:03 -0000	1.22
+++ docs/html/install.html	3 Feb 2003 16:38:16 -0000
@@ -99,7 +99,8 @@
 
       <dd>If gcc 3.1.0 or later on is being used on linux, an attempt
       will be made to use "C" library functionality necessary for C++
-      named locale support. 
+      named locale support.  For gcc 3.2.1 and later, this means that
+      glibc 2.2.5 or later is required.
 
       <p>
       The configure option --enable-clocale can be used force a
Index: docs/html/faq/index.html
===================================================================
RCS file: /cvs/gcc/gcc/libstdc++-v3/docs/html/faq/index.html,v
retrieving revision 1.49
diff -u -3 -p -r1.49 index.html
--- docs/html/faq/index.html	1 Feb 2003 21:47:13 -0000	1.49
+++ docs/html/faq/index.html	3 Feb 2003 16:38:16 -0000
@@ -499,7 +499,7 @@ which is no longer available, thanks dej
       </p>
 
 <hr />
-   <h2><a name="3_7">Threading is broken on i386</a></h2>
+   <h2><a name="3_7">3.7 Threading is broken on i386</a></h2>
       <p>Support for atomic integer operations is/was broken on i386
          platforms.  The assembly code accidentally used opcodes that are
          only available on the i486 and later.  So if you configured GCC
@@ -508,6 +508,18 @@ which is no longer available, thanks dej
          actually running the code on a i386 will the problem appear.  
       </p>
       <p>This is fixed in 3.2.2.
+      </p>
+
+<hr />
+   <h2><a name="3_8">3.8 Recent GNU/Linux glibc required?</a></h2>
+      <p>For 3.2.1 (shared library version 5.0.1) and later, the library
+         uses localization and formatting code from the system C library
+         (glibc) version 2.2.5.  That version of glibc is over a year old
+         and contains necessary bugfixes.  Many GNU/Linux distros make
+         glibc version 2.3.x available now.
+      </p>
+      <p>The guideline is simple:  the more recent the C++ library, the
+         more recent the C library.
       </p>
 
 <hr />


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]