Skip to content

R
riscv-gcc-1
Commit 9b8fd32c by Phil Edwards
Options

acinclude.m4: Cosmetic changes only. 

2001-01-23  Phil Edwards  <pme@sources.redhat.com>

	* acinclude.m4:  Cosmetic changes only.
	* aclocal.m4:  Regenerated.
	* configure:  Regenerated.
	* configure.target:  Update documented list of changed variables.
	* docs/html/install.html:  Fix typo.
	* docs/html/20_util/howto.html:  More notes on auto_ptr.
	* docs/html/27_io/howto.html:  More notes on streabufs.
	* docs/html/faq/index.html:  Add rel_ops problem and mention the
	  DEC as(1) .subsection difficulty.
	* docs/html/faq/index.txt:  Regenerated.

From-SVN: r39200
parent 44f715c8
Showing with 304 additions and 143 deletions
libstdc++-v3/ChangeLog
2001-01-23 Phil Edwards <pme@sources.redhat.com>
* acinclude.m4: Cosmetic changes only.
* aclocal.m4: Regenerated.
* configure: Regenerated.
* configure.target: Update documented list of changed variables.
* docs/html/install.html: Fix typo.
* docs/html/20_util/howto.html: More notes on auto_ptr.
* docs/html/27_io/howto.html: More notes on streabufs.
* docs/html/faq/index.html: Add rel_ops problem and mention the
DEC as(1) .subsection difficulty.
* docs/html/faq/index.txt: Regenerated.
2001-01-23 Mark Mitchell <mark@codesourcery.com>
* ainclude.m4 (GLIBCPP_CHEC_MATH_DECLS_AND_LINKAGE_1): New macro.
(GLIBCPP_CHECK_MATH_SUPPORT): Use it.
(GLIBCPP_CHECK_TYPE_SUPPORT): Don't autoconf ctype information if
its already provided in config.target.
* aclocal.m4: Regenerated.
* configure: Likewise.
* configure.target: Set ctype_include_dir for lots of systems.
* libsupc++/Makefile.am: Explicitly include --tag disable-shared.
* libsupc++/Makefile.in: Regenerated.
2001-01-23 Gabriel Dos Reis <gdr@codesourcery.com> 2001-01-23 Gabriel Dos Reis <gdr@codesourcery.com>
* testsuite/lib/libstdc++.exp: Improve. Add support for @xxx# * testsuite/lib/libstdc++.exp: Improve. Add support for @xxx#
......
libstdc++-v3/acinclude.m4
...@@ -356,7 +356,7 @@ AC_DEFUN(GLIBCPP_CHECK_MATH_DECL_AND_LINKAGE_1, [ ...@@ -356,7 +356,7 @@ AC_DEFUN(GLIBCPP_CHECK_MATH_DECL_AND_LINKAGE_1, [
dnl dnl
dnl Like GLIBCPP_CHECK_MATH_DECL_AND_LINKAGE_1, but does a bunch of dnl Like GLIBCPP_CHECK_MATH_DECL_AND_LINKAGE_1, but does a bunch of
dnl of functions at once. It's an all-or-nothing check -- either dnl of functions at once. It's an all-or-nothing check -- either
dnl HAVE_XYZ is defined for each of the functions, or for none of them dnl HAVE_XYZ is defined for each of the functions, or for none of them.
dnl Doing it this way saves significant configure time. dnl Doing it this way saves significant configure time.
AC_DEFUN(GLIBCPP_CHECK_MATH_DECLS_AND_LINKAGES_1, [ AC_DEFUN(GLIBCPP_CHECK_MATH_DECLS_AND_LINKAGES_1, [
AC_MSG_CHECKING([for $1 functions]) AC_MSG_CHECKING([for $1 functions])
......
libstdc++-v3/aclocal.m4
...@@ -368,7 +368,7 @@ AC_DEFUN(GLIBCPP_CHECK_MATH_DECL_AND_LINKAGE_1, [ ...@@ -368,7 +368,7 @@ AC_DEFUN(GLIBCPP_CHECK_MATH_DECL_AND_LINKAGE_1, [
dnl dnl
dnl Like GLIBCPP_CHECK_MATH_DECL_AND_LINKAGE_1, but does a bunch of dnl Like GLIBCPP_CHECK_MATH_DECL_AND_LINKAGE_1, but does a bunch of
dnl of functions at once. It's an all-or-nothing check -- either dnl of functions at once. It's an all-or-nothing check -- either
dnl HAVE_XYZ is defined for each of the functions, or for none of them dnl HAVE_XYZ is defined for each of the functions, or for none of them.
dnl Doing it this way saves significant configure time. dnl Doing it this way saves significant configure time.
AC_DEFUN(GLIBCPP_CHECK_MATH_DECLS_AND_LINKAGES_1, [ AC_DEFUN(GLIBCPP_CHECK_MATH_DECLS_AND_LINKAGES_1, [
AC_MSG_CHECKING([for $1 functions]) AC_MSG_CHECKING([for $1 functions])
......
libstdc++-v3/configure
This source diff could not be displayed because it is too large. You can view the blob instead.
libstdc++-v3/configure.target
...@@ -20,6 +20,7 @@ ...@@ -20,6 +20,7 @@
# glibcpp_cxxflags Special CXXFLAGS to use when building # glibcpp_cxxflags Special CXXFLAGS to use when building
# cpu_include_dir CPU-specific include directory, relative to srcdir # cpu_include_dir CPU-specific include directory, relative to srcdir
# os_include_dir OS-specific include directory, relative to srcdir # os_include_dir OS-specific include directory, relative to srcdir
# ctype_include_dir Platform-specific (usually OS) ctype include dir
# The first two are set in configure.host and modified here. # The first two are set in configure.host and modified here.
......
libstdc++-v3/docs/html/20_util/howto.html
...@@ -8,7 +8,7 @@ ...@@ -8,7 +8,7 @@
<META NAME="GENERATOR" CONTENT="vi and eight fingers"> <META NAME="GENERATOR" CONTENT="vi and eight fingers">
<TITLE>libstdc++-v3 HOWTO: Chapter 20</TITLE> <TITLE>libstdc++-v3 HOWTO: Chapter 20</TITLE>
<LINK REL=StyleSheet HREF="../lib3styles.css"> <LINK REL=StyleSheet HREF="../lib3styles.css">
<!-- $Id: howto.html,v 1.4 2000/12/03 23:47:47 jsm28 Exp $ --> <!-- $Id: howto.html,v 1.1 2000/12/10 04:04:54 pme Exp $ -->
</HEAD> </HEAD>
<BODY> <BODY>
...@@ -24,7 +24,7 @@ ...@@ -24,7 +24,7 @@
<H1>Contents</H1> <H1>Contents</H1>
<UL> <UL>
<LI><A HREF="#1"><TT>auto_ptr</TT> is not omnipotent</A> <LI><A HREF="#1"><TT>auto_ptr</TT> is not omnipotent</A>
<LI><A HREF="#2">Automatically-generated operators</A> <LI><A HREF="#2"><TT>auto_ptr</TT> inside container classes</A>
<LI><A HREF="#3">Functors</A> <LI><A HREF="#3">Functors</A>
<LI><A HREF="#4">Pairs</A> <LI><A HREF="#4">Pairs</A>
</UL> </UL>
...@@ -82,32 +82,61 @@ ...@@ -82,32 +82,61 @@
to one or many things. If it points to many things, you are about to one or many things. If it points to many things, you are about
to die. AP is trivial to write, however, so you could write your to die. AP is trivial to write, however, so you could write your
own <TT>auto_array_ptr</TT> for that situation (in fact, this has own <TT>auto_array_ptr</TT> for that situation (in fact, this has
been done many times; check the newsgroups, Usenet, Boost, etc). been done many times; check the mailing lists, Usenet, Boost, etc).
</P> </P>
<P>Return <A HREF="#top">to top of page</A> or <P>Return <A HREF="#top">to top of page</A> or
<A HREF="../faq/index.html">to the FAQ</A>. <A HREF="../faq/index.html">to the FAQ</A>.
</P> </P>
<HR> <HR>
<H2><A NAME="2">Automatically-generated operators</A></H2> <H2><A NAME="2"><TT>auto_ptr</TT> inside container classes</A></H2>
<P>Many programs (for that matter, many of the Standard algorithms <P>All of the <A HREF="../23_containers/howto.html">containers</A>
and containers) require that you write comparison operators for described in the standard library require their contained types
your classes, like <TT>operator&gt;=</TT>. As any mathmatician to have, among other things, a copy contructor like this:
will tell you, once you have defined equality and ordering, all
of the other comparisons are easily defined in terms of those two.
</P>
<P>The Committee agrees. So, once you have written
<TT>operator==</TT> and <TT>operator&lt;</TT> for your class
(whether they are global or member functions is up to you), you
can have the compiler do the grunt-work of generating the rest:
<PRE> <PRE>
#include &lt;header_with_my_op==_and_op&lt;_defined&gt; struct My_Type
#include &lt;utility&gt; {
using std::rel_ops; // note the nested namespace! My_Type (My_Type const&amp;);
};
</PRE>
Note the const keyword; the object being copied shouldn't change.
The template class <TT>auto_ptr</TT> (called AP here) does not
meet this requirement. Creating a new AP by copying an existing
one transfers ownership of the pointed-to object, which means that
the AP being copied must change, which in turn means that the
copy ctors of AP do not take const objects.
</P>
<P>The resulting rule is simple: <EM>Never ever use a container of
auto_ptr objects.</EM> The standard says that undefined behavior
is the result, but it is guaranteed to be messy.
</P>
<P>To prevent you from doing this to yourself, the
<A HREF="../19_diagnostics/howto.html#3">concept checks</A> built
in to this implementation will issue an error if you try to
compile code like this:
<PRE>
#include &lt;vector&gt;
#include &lt;memory&gt;
... void f()
if ((obj1 != obj2) || (obj3 >= obj4)) foo(); {
std::vector&lt; std::auto_ptr&lt;int&gt; &gt; vec_ap_int;
}
</PRE>
Should you try this, you will see an error along the lines of the
following (look through the ugly line-wrapping):
<PRE>
/installdir/include/g++-v3/bits/concept_checks.h: In
static member function `static _Type
<B>_STL_ERROR::__const_parameter_required_for_copy_constructor</B>(_Type, const
_Type&amp;) [with _Type = std::auto_ptr&lt;int&gt;]':
/installdir/include/g++-v3/bits/concept_checks.h:383: passing
`const std::auto_ptr&lt;int&gt;' as `this' argument of
`std::auto_ptr&lt;_Tp&gt;::operator std::auto_ptr_ref&lt;_Tp1&gt;()
[with _Tp1 = int, _Tp = int]' discards qualifiers
</PRE> </PRE>
See the highlighted error? It starts with a message in all caps
to get your attention.
</P> </P>
<P>Return <A HREF="#top">to top of page</A> or <P>Return <A HREF="#top">to top of page</A> or
<A HREF="../faq/index.html">to the FAQ</A>. <A HREF="../faq/index.html">to the FAQ</A>.
...@@ -185,7 +214,7 @@ ...@@ -185,7 +214,7 @@
Comments and suggestions are welcome, and may be sent to Comments and suggestions are welcome, and may be sent to
<A HREF="mailto:pme@sources.redhat.com">Phil Edwards</A> or <A HREF="mailto:pme@sources.redhat.com">Phil Edwards</A> or
<A HREF="mailto:gdr@gcc.gnu.org">Gabriel Dos Reis</A>. <A HREF="mailto:gdr@gcc.gnu.org">Gabriel Dos Reis</A>.
<BR> $Id: howto.html,v 1.4 2000/12/03 23:47:47 jsm28 Exp $ <BR> $Id: howto.html,v 1.1 2000/12/10 04:04:54 pme Exp $
</EM></P> </EM></P>
......
libstdc++-v3/docs/html/27_io/howto.html
...@@ -8,7 +8,7 @@ ...@@ -8,7 +8,7 @@
<META NAME="GENERATOR" CONTENT="vi and eight fingers"> <META NAME="GENERATOR" CONTENT="vi and eight fingers">
<TITLE>libstdc++-v3 HOWTO: Chapter 27</TITLE> <TITLE>libstdc++-v3 HOWTO: Chapter 27</TITLE>
<LINK REL=StyleSheet HREF="../lib3styles.css"> <LINK REL=StyleSheet HREF="../lib3styles.css">
<!-- $Id: howto.html,v 1.5 2000/12/03 23:47:49 jsm28 Exp $ --> <!-- $Id: howto.html,v 1.1 2000/12/10 04:04:56 pme Exp $ -->
</HEAD> </HEAD>
<BODY> <BODY>
...@@ -28,6 +28,7 @@ ...@@ -28,6 +28,7 @@
<LI><A HREF="#3">Binary I/O</A> <LI><A HREF="#3">Binary I/O</A>
<LI><A HREF="#4">Iostreams class hierarchy diagram</A> <LI><A HREF="#4">Iostreams class hierarchy diagram</A>
<LI><A HREF="#5">What is this &lt;sstream&gt;/stringstreams thing?</A> <LI><A HREF="#5">What is this &lt;sstream&gt;/stringstreams thing?</A>
<LI><A HREF="#6">Deriving a stream buffer</A>
</UL> </UL>
<HR> <HR>
...@@ -327,6 +328,61 @@ ...@@ -327,6 +328,61 @@
support them, and 2) if you use them, people will laugh at you. support them, and 2) if you use them, people will laugh at you.
</P> </P>
<HR>
<H2><A NAME="6">Deriving a stream buffer</A></H2>
<P>Creating your own stream buffers for I/O can be remarkably easy.
If you are interested in doing so, we highly recommend two very
excellent books: <EM>Standard C++ IOStreams and Locales</EM> by
Langer and Kreft, ISBN 0-201-18395-1, and
<A HREF="http://www.josuttis.com/libbook/">The C++ Standard Library</A>
by Nicolai Josuttis, ISBN 0-201-37926-0. Both are published by
Addison-Wesley, who isn't paying us a cent for saying that, honest.
</P>
<P>Here is a simple example, io/outbuf1, from the Josuttis text. It
transforms everything sent through it to uppercase. This version
assumes many things about the nature of the character type being
used (for more information, read the books or the newsgroups):
<PRE>
#include &lt;iostream&gt;
#include &lt;streambuf&gt;
#include &lt;locale&gt;
#include &lt;cstdio&gt;
class outbuf : public std::streambuf
{
protected:
/* central output function
* - print characters in uppercase mode
*/
virtual int_type overflow (int_type c) {
if (c != EOF) {
// convert lowercase to uppercase
c = std::toupper(static_cast&lt;char&gt;(c),getloc());
// and write the character to the standard output
if (putchar(c) == EOF) {
return EOF;
}
}
return c;
}
};
int main()
{
// create special output buffer
outbuf ob;
// initialize output stream with that output buffer
std::ostream out(&ob);
out &lt;&lt; "31 hexadecimal: "
&lt;&lt; std::hex &lt;&lt; 31 &lt;&lt; std::endl;
return 0;
}
</PRE>
Try it yourself!
</P>
<!-- ####################################################### --> <!-- ####################################################### -->
...@@ -335,7 +391,7 @@ ...@@ -335,7 +391,7 @@
Comments and suggestions are welcome, and may be sent to Comments and suggestions are welcome, and may be sent to
<A HREF="mailto:pme@sources.redhat.com">Phil Edwards</A> or <A HREF="mailto:pme@sources.redhat.com">Phil Edwards</A> or
<A HREF="mailto:gdr@gcc.gnu.org">Gabriel Dos Reis</A>. <A HREF="mailto:gdr@gcc.gnu.org">Gabriel Dos Reis</A>.
<BR> $Id: howto.html,v 1.5 2000/12/03 23:47:49 jsm28 Exp $ <BR> $Id: howto.html,v 1.1 2000/12/10 04:04:56 pme Exp $
</EM></P> </EM></P>
......
libstdc++-v3/docs/html/faq/index.html
...@@ -9,7 +9,7 @@ ...@@ -9,7 +9,7 @@
** Locations of "the most recent snapshot is the Nth" text are ** Locations of "the most recent snapshot is the Nth" text are
** answers 1_1, 1_4, 4_1, 5_6. ** answers 1_1, 1_4, 4_1, 5_6.
--> -->
<!-- $Id: index.html,v 1.10 2000/12/03 23:47:49 jsm28 Exp $ --> <!-- $Id: index.html,v 1.1 2000/12/10 04:04:56 pme Exp $ -->
</HEAD> </HEAD>
<BODY> <BODY>
...@@ -53,6 +53,7 @@ http://gcc.gnu.org/onlinedocs/libstdc++/faq/</A>.</P> ...@@ -53,6 +53,7 @@ http://gcc.gnu.org/onlinedocs/libstdc++/faq/</A>.</P>
<LI><A HREF="#3_1">Can libstdc++-v3 be used with &lt;my <LI><A HREF="#3_1">Can libstdc++-v3 be used with &lt;my
favorite compiler&gt;?</A> favorite compiler&gt;?</A>
<LI><A HREF="#3_2">Building under Cygwin hangs/explodes!?</A> <LI><A HREF="#3_2">Building under Cygwin hangs/explodes!?</A>
<LI><A HREF="#3_3">Building under DEC OSF kills the assembler</A>
</OL> </OL>
<LI><A HREF="#4_0">Known Bugs and Non-Bugs</A> <LI><A HREF="#4_0">Known Bugs and Non-Bugs</A>
...@@ -370,6 +371,22 @@ HREF="http://sources.redhat.com/automake/">automake</A>. ...@@ -370,6 +371,22 @@ HREF="http://sources.redhat.com/automake/">automake</A>.
</P> </P>
<HR> <HR>
<H2><A NAME="3_3">3.3 Building DEC OSF kills the assembler</A></H2>
<P>The <TT>atomicity.h</TT> header for the Alpha processor
currently uses pseudo-operators which the DEC assembler
doesn't understand (in particular, .subsection and .previous).
The simple solution is to install GNU <TT>as</TT> and arrange
for the GCC build to use it (or merge the sources and build
it during the bootstrap).
</P>
<P>Anyone who
<A HREF="http://gcc.gnu.org/ml/libstdc++/2000-12/msg00279.html">knows
the DEC assembler well enough</A> to provide the equivalent of
these two pseudos would win praise and accolades from many.
</P>
<HR>
<H1><A NAME="4_0">4.0 Known Bugs and Non-Bugs</A></H1> <H1><A NAME="4_0">4.0 Known Bugs and Non-Bugs</A></H1>
<EM>Note that this section can get rapdily outdated -- such is the <EM>Note that this section can get rapdily outdated -- such is the
nature of an open-source project. For the latest information, join nature of an open-source project. For the latest information, join
...@@ -482,6 +499,15 @@ to the list</A>, Nathan Myers announced that he has started a list of ...@@ -482,6 +499,15 @@ to the list</A>, Nathan Myers announced that he has started a list of
necessarily trying to be OO. There are multiple solutions necessarily trying to be OO. There are multiple solutions
under discussion. under discussion.
</P> </P>
<P>Another is the <TT>rel_ops</TT> namespace and the template
comparison operator functions contained therein. If they become
visible in the same namespace as other comparison functions
(e.g., '<TT>using</TT>' them and the &lt;iterator&gt; header),
then you will suddenly be faced with huge numbers of ambiguity
errors. This was discussed on the -v3 list; Nathan Myers
<A HREF="http://gcc.gnu.org/ml/libstdc++/2001-01/msg00247.html">sums
things up here</A>.
</P>
<H3><A NAME="4_4_interface">The g++-3 headers are <H3><A NAME="4_4_interface">The g++-3 headers are
<EM>not ours</EM></A></H3> <EM>not ours</EM></A></H3>
<P>If you have found an extremely broken header file which is <P>If you have found an extremely broken header file which is
...@@ -572,7 +598,7 @@ HREF="http://gcc.gnu.org/ml/libstdc++/1999/msg00084.html">speculation</A>. ...@@ -572,7 +598,7 @@ HREF="http://gcc.gnu.org/ml/libstdc++/1999/msg00084.html">speculation</A>.
is merged into libstdc++-v3 with changes as necessary. is merged into libstdc++-v3 with changes as necessary.
Currently release 3.3 is being used. Changes in the STL Currently release 3.3 is being used. Changes in the STL
usually produce some weird bugs and lots of changes in the usually produce some weird bugs and lots of changes in the
rest of the libstd++ source as we scramble to keep up. :-) rest of the libstdc++ source as we scramble to keep up. :-)
</P> </P>
<P>In particular, <TT>string</TT> is not from SGI and makes no <P>In particular, <TT>string</TT> is not from SGI and makes no
use of their &quot;rope&quot; class (which is included as an use of their &quot;rope&quot; class (which is included as an
...@@ -652,7 +678,7 @@ HREF="http://gcc.gnu.org/ml/libstdc++/1999/msg00084.html">speculation</A>. ...@@ -652,7 +678,7 @@ HREF="http://gcc.gnu.org/ml/libstdc++/1999/msg00084.html">speculation</A>.
Comments and suggestions are welcome, and may be sent to Comments and suggestions are welcome, and may be sent to
<A HREF="mailto:pme@sources.redhat.com">Phil Edwards</A> or <A HREF="mailto:pme@sources.redhat.com">Phil Edwards</A> or
<A HREF="mailto:gdr@gcc.gnu.org">Gabriel Dos Reis</A>. <A HREF="mailto:gdr@gcc.gnu.org">Gabriel Dos Reis</A>.
<BR> $Id: index.html,v 1.10 2000/12/03 23:47:49 jsm28 Exp $ <BR> $Id: index.html,v 1.1 2000/12/10 04:04:56 pme Exp $
</EM></P> </EM></P>
......
libstdc++-v3/docs/html/faq/index.txt
...@@ -27,22 +27,23 @@ ...@@ -27,22 +27,23 @@
3. [17]Platform-Specific Issues 3. [17]Platform-Specific Issues
1. [18]Can libstdc++-v3 be used with <my favorite compiler>? 1. [18]Can libstdc++-v3 be used with <my favorite compiler>?
2. [19]Building under Cygwin hangs/explodes!? 2. [19]Building under Cygwin hangs/explodes!?
4. [20]Known Bugs and Non-Bugs 3. [20]Building under DEC OSF kills the assembler
1. [21]What works already? 4. [21]Known Bugs and Non-Bugs
2. [22]Bugs in gcc/g++ (not libstdc++-v3) 1. [22]What works already?
3. [23]Bugs in the C++ language/lib specification 2. [23]Bugs in gcc/g++ (not libstdc++-v3)
4. [24]Things in libstdc++ that look like bugs 3. [24]Bugs in the C++ language/lib specification
[25]The g++-3 headers are not ours 4. [25]Things in libstdc++ that look like bugs
5. [26]Aw, that's easy to fix! [26]The g++-3 headers are not ours
5. [27]Miscellaneous 5. [27]Aw, that's easy to fix!
1. [28]string::iterator is not char*; vector<T>::iterator is not 5. [28]Miscellaneous
1. [29]string::iterator is not char*; vector<T>::iterator is not
T* T*
2. [29]What's next after libstdc++-v3? 2. [30]What's next after libstdc++-v3?
3. [30]What about the STL from SGI? 3. [31]What about the STL from SGI?
4. [31]Extensions and Backward Compatibility 4. [32]Extensions and Backward Compatibility
5. [32]Compiling with "-fnew-abi" 5. [33]Compiling with "-fnew-abi"
6. [33]Is libstdc++-v3 thread-safe? 6. [34]Is libstdc++-v3 thread-safe?
7. [34]How do I get a copy of the ISO C++ Standard? 7. [35]How do I get a copy of the ISO C++ Standard?
_________________________________________________________________ _________________________________________________________________
1.0 General Information 1.0 General Information
...@@ -53,13 +54,13 @@ ...@@ -53,13 +54,13 @@
ongoing project to implement the ISO 14882 Standard C++ library as ongoing project to implement the ISO 14882 Standard C++ library as
described in chapters 17 through 27 and annex D. As the library described in chapters 17 through 27 and annex D. As the library
reaches stable plateaus, it is captured in a snapshot and released. reaches stable plateaus, it is captured in a snapshot and released.
The current release is [35]the tenth snapshot. For those who want to The current release is [36]the tenth snapshot. For those who want to
see exactly how far the project has come, or just want the latest see exactly how far the project has come, or just want the latest
bleeding-edge code, the up-to-date source is available over anonymous bleeding-edge code, the up-to-date source is available over anonymous
CVS, and can even be browsed over the Web (see below). CVS, and can even be browsed over the Web (see below).
A more formal description of the V3 goals can be found in the official A more formal description of the V3 goals can be found in the official
[36]design document. [37]design document.
_________________________________________________________________ _________________________________________________________________
1.2 Why should I use libstdc++? 1.2 Why should I use libstdc++?
...@@ -72,8 +73,8 @@ ...@@ -72,8 +73,8 @@
The GNU C/C++/FORTRAN/<pick-a-language> compiler (gcc, g++, etc) is The GNU C/C++/FORTRAN/<pick-a-language> compiler (gcc, g++, etc) is
widely considered to be one of the leading compilers in the world. Its widely considered to be one of the leading compilers in the world. Its
development has recently been taken over by the [37]GCC team. All of development has recently been taken over by the [38]GCC team. All of
the rapid development and near-legendary [38]portability that are the the rapid development and near-legendary [39]portability that are the
hallmarks of an open-source project are being applied to libstdc++. hallmarks of an open-source project are being applied to libstdc++.
That means that all of the Standard classes and functions (such as That means that all of the Standard classes and functions (such as
...@@ -91,16 +92,16 @@ ...@@ -91,16 +92,16 @@
Development and discussion is held on the libstdc++ mailing list. Development and discussion is held on the libstdc++ mailing list.
Subscribing to the list, or searching the list archives, is open to Subscribing to the list, or searching the list archives, is open to
everyone. You can read instructions for doing so on the [39]homepage. everyone. You can read instructions for doing so on the [40]homepage.
If you have questions, ideas, code, or are just curious, sign up! If you have questions, ideas, code, or are just curious, sign up!
_________________________________________________________________ _________________________________________________________________
1.4 How do I get libstdc++? 1.4 How do I get libstdc++?
The tenth (and latest) snapshot of libstdc++-v3 is [40]available via The tenth (and latest) snapshot of libstdc++-v3 is [41]available via
ftp. ftp.
The [41]homepage has instructions for retrieving the latest CVS The [42]homepage has instructions for retrieving the latest CVS
sources, and for browsing the CVS sources over the web. sources, and for browsing the CVS sources over the web.
The subset commonly known as the Standard Template Library (chapters The subset commonly known as the Standard Template Library (chapters
...@@ -116,7 +117,7 @@ ...@@ -116,7 +117,7 @@
1.6 How do I contribute to the effort? 1.6 How do I contribute to the effort?
Here is [42]a page devoted to this topic. Subscribing to the mailing Here is [43]a page devoted to this topic. Subscribing to the mailing
list (see above, or the homepage) is a very good idea if you have list (see above, or the homepage) is a very good idea if you have
something to contribute, or if you have spare time and want to help. something to contribute, or if you have spare time and want to help.
Contributions don't have to be in the form of source code; anybody who Contributions don't have to be in the form of source code; anybody who
...@@ -151,11 +152,11 @@ ...@@ -151,11 +152,11 @@
extracted into an updated utilities library, but nobody has stated extracted into an updated utilities library, but nobody has stated
such a project yet. such a project yet.
(The [43]Boost site houses free C++ libraries that do varying things, (The [44]Boost site houses free C++ libraries that do varying things,
and happened to be started by members of the Standards Committee. and happened to be started by members of the Standards Committee.
Certain "useful stuff" classes will probably migrate there.) Certain "useful stuff" classes will probably migrate there.)
For the bold and/or desperate, the [44]GCC FAQ describes where to find For the bold and/or desperate, the [45]GCC FAQ describes where to find
the last libg++ source. the last libg++ source.
_________________________________________________________________ _________________________________________________________________
...@@ -165,11 +166,11 @@ ...@@ -165,11 +166,11 @@
remains unanswered, then just ask the mailing list. At present, you do remains unanswered, then just ask the mailing list. At present, you do
not need to be subscribed to the list to send a message to it. More not need to be subscribed to the list to send a message to it. More
information is available on the homepage (including how to browse the information is available on the homepage (including how to browse the
list archives); to send to the list, use [45]libstdc++@gcc.gnu.org. list archives); to send to the list, use [46]libstdc++@gcc.gnu.org.
If you have a question that you think should be included here, or if If you have a question that you think should be included here, or if
you have a question about a question/answer here, contact [46]Phil you have a question about a question/answer here, contact [47]Phil
Edwards or [47]Gabriel Dos Reis. Edwards or [48]Gabriel Dos Reis.
_________________________________________________________________ _________________________________________________________________
2.0 Installation 2.0 Installation
...@@ -183,15 +184,15 @@ ...@@ -183,15 +184,15 @@
GCC is much easier and more automated than building the GCC 2.[78] GCC is much easier and more automated than building the GCC 2.[78]
series was. series was.
* If you plan on hacking around with the makefiles, you will need * If you plan on hacking around with the makefiles, you will need
the tools [48]autoconfand [49]automake. the tools [49]autoconfand [50]automake.
* GNU Make is the only make that supports these makefiles. * GNU Make is the only make that supports these makefiles.
The file [50]documentation.html provides a good overview of the steps The file [51]documentation.html provides a good overview of the steps
necessary to build, install, and use the library. Instructions for necessary to build, install, and use the library. Instructions for
configuring the library with new flags such as --enable-threads are configuring the library with new flags such as --enable-threads are
there also. there also.
The top-level install.html and [51]RELEASE-NOTES files contain the The top-level install.html and [52]RELEASE-NOTES files contain the
exact build and installation instructions. You may wish to browse exact build and installation instructions. You may wish to browse
those files over CVSweb ahead of time to get a feel for what's those files over CVSweb ahead of time to get a feel for what's
required. RELEASE-NOTES is located in the ".../docs/17_intro/" required. RELEASE-NOTES is located in the ".../docs/17_intro/"
...@@ -209,8 +210,8 @@ ...@@ -209,8 +210,8 @@
The Concurrent Versions System is one of several revision control The Concurrent Versions System is one of several revision control
packages. It was selected for GNU projects because it's free (speech), packages. It was selected for GNU projects because it's free (speech),
free (beer), and very high quality. The [52]CVS entry in the GNU free (beer), and very high quality. The [53]CVS entry in the GNU
software catalogue has a better description as well as a [53]link to software catalogue has a better description as well as a [54]link to
the makers of CVS. the makers of CVS.
The "anonymous client checkout" feature of CVS is similar to anonymous The "anonymous client checkout" feature of CVS is similar to anonymous
...@@ -280,9 +281,22 @@ ...@@ -280,9 +281,22 @@
doesn't prevent hanging elsewhere. doesn't prevent hanging elsewhere.
You have two options. You can get a newer cygwin1.dll (see the Cygwin You have two options. You can get a newer cygwin1.dll (see the Cygwin
paragraph in the [54]installation instructions). Or you can get a paragraph in the [55]installation instructions). Or you can get a
prebuilt set of bits/std_limits.h and src/limitsMEMBERS.cc files from prebuilt set of bits/std_limits.h and src/limitsMEMBERS.cc files from
Mumit Khan's [55]Cygwin-related website. Mumit Khan's [56]Cygwin-related website.
_________________________________________________________________
3.3 Building DEC OSF kills the assembler
The atomicity.h header for the Alpha processor currently uses
pseudo-operators which the DEC assembler doesn't understand (in
particular, .subsection and .previous). The simple solution is to
install GNU as and arrange for the GCC build to use it (or merge the
sources and build it during the bootstrap).
Anyone who [57]knows the DEC assembler well enough to provide the
equivalent of these two pseudos would win praise and accolades from
many.
_________________________________________________________________ _________________________________________________________________
4.0 Known Bugs and Non-Bugs 4.0 Known Bugs and Non-Bugs
...@@ -360,16 +374,16 @@ New: ...@@ -360,16 +374,16 @@ New:
4.3 Bugs in the C++ language/lib specification 4.3 Bugs in the C++ language/lib specification
Yes, unfortunately, there are some. In a [56]message to the list, Yes, unfortunately, there are some. In a [58]message to the list,
Nathan Myers announced that he has started a list of problems in the Nathan Myers announced that he has started a list of problems in the
ISO C++ Standard itself, especially with regard to the chapters that ISO C++ Standard itself, especially with regard to the chapters that
concern the library. The list itself is [57]posted on his website. concern the library. The list itself is [59]posted on his website.
Developers who are having problems interpreting the Standard may wish Developers who are having problems interpreting the Standard may wish
to consult his notes. to consult his notes.
For those people who are not part of the ISO Library Group (i.e., For those people who are not part of the ISO Library Group (i.e.,
nearly all of us needing to read this page in the first place :-), a nearly all of us needing to read this page in the first place :-), a
public list of the library defects is occasionally published [58]here. public list of the library defects is occasionally published [60]here.
_________________________________________________________________ _________________________________________________________________
4.4 Things in libstdc++ that look like bugs 4.4 Things in libstdc++ that look like bugs
...@@ -385,12 +399,19 @@ New: ...@@ -385,12 +399,19 @@ New:
while the Standard Library isn't necessarily trying to be OO. There while the Standard Library isn't necessarily trying to be OO. There
are multiple solutions under discussion. are multiple solutions under discussion.
Another is the rel_ops namespace and the template comparison operator
functions contained therein. If they become visible in the same
namespace as other comparison functions (e.g., 'using' them and the
<iterator> header), then you will suddenly be faced with huge numbers
of ambiguity errors. This was discussed on the -v3 list; Nathan Myers
[61]sums things up here.
The g++-3 headers are not ours The g++-3 headers are not ours
If you have found an extremely broken header file which is causing If you have found an extremely broken header file which is causing
problems for you, look carefully before submitting a "high" priority problems for you, look carefully before submitting a "high" priority
bug report (which you probably shouldn't do anyhow; see the last bug report (which you probably shouldn't do anyhow; see the last
paragraph of the page describing [59]the GCC bug database). paragraph of the page describing [62]the GCC bug database).
If the headers are in ${prefix}/include/g++-3, then you are using the If the headers are in ${prefix}/include/g++-3, then you are using the
old libstdc++-v2 library, which is nonstandard and unmaintained. Do old libstdc++-v2 library, which is nonstandard and unmaintained. Do
...@@ -398,23 +419,23 @@ New: ...@@ -398,23 +419,23 @@ New:
Currently our header files are installed in ${prefix}/include/g++-v3 Currently our header files are installed in ${prefix}/include/g++-v3
(see the 'v'?). This may change with the next release of GCC, as it (see the 'v'?). This may change with the next release of GCC, as it
may be too confusing, but [60]the question has not yet been decided. may be too confusing, but [63]the question has not yet been decided.
_________________________________________________________________ _________________________________________________________________
4.5 Aw, that's easy to fix! 4.5 Aw, that's easy to fix!
If you have found a bug in the library and you think you have a If you have found a bug in the library and you think you have a
working fix, then send it in! The main GCC site has a page on working fix, then send it in! The main GCC site has a page on
[61]submitting patches that covers the procedure, but for libstdc++ [64]submitting patches that covers the procedure, but for libstdc++
you should of course send the patch to our mailing list, not the GCC you should of course send the patch to our mailing list, not the GCC
mailing list. The libstdc++ [62]contributors' page also talks about mailing list. The libstdc++ [65]contributors' page also talks about
how to submit patches. how to submit patches.
In addition to the description, the patch, and the ChangeLog entry, it In addition to the description, the patch, and the ChangeLog entry, it
is a Good Thing if you can additionally create a small test program to is a Good Thing if you can additionally create a small test program to
test for the presence of the bug that your patch fixes. Bugs have a test for the presence of the bug that your patch fixes. Bugs have a
way of being reintroduced; if an old bug creeps back in, it will be way of being reintroduced; if an old bug creeps back in, it will be
caught immediately by the [63]testsuite -- but only if such a test caught immediately by the [66]testsuite -- but only if such a test
exists. exists.
_________________________________________________________________ _________________________________________________________________
...@@ -452,16 +473,16 @@ New: ...@@ -452,16 +473,16 @@ New:
Bugfixes and rewrites (to improve or fix thread safety, for instance) Bugfixes and rewrites (to improve or fix thread safety, for instance)
will of course be a continuing task. will of course be a continuing task.
[64]This question about the next libstdc++ prompted some brief but [67]This question about the next libstdc++ prompted some brief but
interesting [65]speculation. interesting [68]speculation.
_________________________________________________________________ _________________________________________________________________
5.3 What about the STL from SGI? 5.3 What about the STL from SGI?
The [66]STL from SGI is merged into libstdc++-v3 with changes as The [69]STL from SGI is merged into libstdc++-v3 with changes as
necessary. Currently release 3.3 is being used. Changes in the STL necessary. Currently release 3.3 is being used. Changes in the STL
usually produce some weird bugs and lots of changes in the rest of the usually produce some weird bugs and lots of changes in the rest of the
libstd++ source as we scramble to keep up. :-) libstdc++ source as we scramble to keep up. :-)
In particular, string is not from SGI and makes no use of their "rope" In particular, string is not from SGI and makes no use of their "rope"
class (which is included as an optional extension), nor is valarray class (which is included as an optional extension), nor is valarray
...@@ -479,13 +500,13 @@ New: ...@@ -479,13 +500,13 @@ New:
#include <ext/hash_map> #include <ext/hash_map>
Extensions to the library have [67]their own page. Extensions to the library have [70]their own page.
_________________________________________________________________ _________________________________________________________________
5.5 Compiling with "-fnew-abi" 5.5 Compiling with "-fnew-abi"
Towards the end of July 1999, this subject was brought up again on the Towards the end of July 1999, this subject was brought up again on the
mailing list under a different name. The related [68]thread (by the mailing list under a different name. The related [71]thread (by the
name HOWTO-honor-std) is very instructive. More info is at the end of name HOWTO-honor-std) is very instructive. More info is at the end of
RELEASE-NOTES. RELEASE-NOTES.
...@@ -499,8 +520,8 @@ New: ...@@ -499,8 +520,8 @@ New:
This is assuming that your idea of "multithreaded" is the same as This is assuming that your idea of "multithreaded" is the same as
ours... The general question of multithreading and libstdc++-v3 is ours... The general question of multithreading and libstdc++-v3 is
addressed in the chapter-specific advice for [69]Library Introduction. addressed in the chapter-specific advice for [72]Library Introduction.
Threadsafe containers are covered in more detail in [70]the Received Threadsafe containers are covered in more detail in [73]the Received
Wisdom section on containers. Wisdom section on containers.
_________________________________________________________________ _________________________________________________________________
...@@ -512,17 +533,17 @@ New: ...@@ -512,17 +533,17 @@ New:
their two-meeting commitment for voting rights, may get a copy of the their two-meeting commitment for voting rights, may get a copy of the
standard from their respective national standards organization. In the standard from their respective national standards organization. In the
USA, this national standards organization is ANSI and their website is USA, this national standards organization is ANSI and their website is
right [71]here. (And if you've already registered with them, clicking right [74]here. (And if you've already registered with them, clicking
this link will take you to directly to the place where you can [72]buy this link will take you to directly to the place where you can [75]buy
the standard on-line. the standard on-line.
Who is your country's member body? Visit the [73]ISO homepage and find Who is your country's member body? Visit the [76]ISO homepage and find
out! out!
_________________________________________________________________ _________________________________________________________________
Comments and suggestions are welcome, and may be sent to [74]Phil Comments and suggestions are welcome, and may be sent to [77]Phil
Edwards or [75]Gabriel Dos Reis. Edwards or [78]Gabriel Dos Reis.
$Id: index.html,v 1.10 2000/12/03 23:47:49 jsm28 Exp $ $Id: index.html,v 1.1 2000/12/10 04:04:56 pme Exp $
References References
...@@ -545,59 +566,62 @@ References ...@@ -545,59 +566,62 @@ References
17. ../faq/index.html#3_0 17. ../faq/index.html#3_0
18. ../faq/index.html#3_1 18. ../faq/index.html#3_1
19. ../faq/index.html#3_2 19. ../faq/index.html#3_2
20. ../faq/index.html#4_0 20. ../faq/index.html#3_3
21. ../faq/index.html#4_1 21. ../faq/index.html#4_0
22. ../faq/index.html#4_2 22. ../faq/index.html#4_1
23. ../faq/index.html#4_3 23. ../faq/index.html#4_2
24. ../faq/index.html#4_4 24. ../faq/index.html#4_3
25. ../faq/index.html#4_4_interface 25. ../faq/index.html#4_4
26. ../faq/index.html#4_5 26. ../faq/index.html#4_4_interface
27. ../faq/index.html#5_0 27. ../faq/index.html#4_5
28. ../faq/index.html#5_1 28. ../faq/index.html#5_0
29. ../faq/index.html#5_2 29. ../faq/index.html#5_1
30. ../faq/index.html#5_3 30. ../faq/index.html#5_2
31. ../faq/index.html#5_4 31. ../faq/index.html#5_3
32. ../faq/index.html#5_5 32. ../faq/index.html#5_4
33. ../faq/index.html#5_6 33. ../faq/index.html#5_5
34. ../faq/index.html#5_7 34. ../faq/index.html#5_6
35. ftp://gcc.gnu.org/pub/libstdc++/libstdc++-2.91.tar.gz 35. ../faq/index.html#5_7
36. ../17_intro/DESIGN 36. ftp://gcc.gnu.org/pub/libstdc++/libstdc++-2.91.tar.gz
37. http://gcc.gnu.org/ 37. ../17_intro/DESIGN
38. http://gcc.gnu.org/gcc-2.95/buildstat.html 38. http://gcc.gnu.org/
39. http://gcc.gnu.org/libstdc++/ 39. http://gcc.gnu.org/gcc-2.95/buildstat.html
40. ftp://gcc.gnu.org/pub/libstdc++/libstdc++-2.91.tar.gz 40. http://gcc.gnu.org/libstdc++/
41. http://gcc.gnu.org/libstdc++/ 41. ftp://gcc.gnu.org/pub/libstdc++/libstdc++-2.91.tar.gz
42. ../17_intro/contribute.html 42. http://gcc.gnu.org/libstdc++/
43. http://www.boost.org/ 43. ../17_intro/contribute.html
44. http://gcc.gnu.org/fom_serv/cache/33.html 44. http://www.boost.org/
45. mailto:libstdc++@gcc.gnu.org 45. http://gcc.gnu.org/fom_serv/cache/33.html
46. mailto:pme@sources.redhat.com 46. mailto:libstdc++@gcc.gnu.org
47. mailto:gdr@gcc.gnu.org 47. mailto:pme@sources.redhat.com
48. http://sources.redhat.com/autoconf/ 48. mailto:gdr@gcc.gnu.org
49. http://sources.redhat.com/automake/ 49. http://sources.redhat.com/autoconf/
50. ../documentation.html 50. http://sources.redhat.com/automake/
51. ../17_intro/RELEASE-NOTES 51. ../documentation.html
52. http://www.gnu.org/software/cvs/cvs.html 52. ../17_intro/RELEASE-NOTES
53. http://www.cyclic.com/ 53. http://www.gnu.org/software/cvs/cvs.html
54. ../install.html 54. http://www.cyclic.com/
55. http://www.xraylith.wisc.edu/~khan/software/gnu-win32/libstdc++-v3.html 55. ../install.html
56. http://gcc.gnu.org/ml/libstdc++/1998/msg00006.html 56. http://www.xraylith.wisc.edu/~khan/software/gnu-win32/libstdc++-v3.html
57. http://www.cantrip.org/draft-bugs.txt 57. http://gcc.gnu.org/ml/libstdc++/2000-12/msg00279.html
58. http://anubis.dkuug.dk/jtc1/sc22/wg21/ 58. http://gcc.gnu.org/ml/libstdc++/1998/msg00006.html
59. http://gcc.gnu.org/gnatswrite.html 59. http://www.cantrip.org/draft-bugs.txt
60. http://gcc.gnu.org/ml/gcc/2000-10/msg00732.html 60. http://anubis.dkuug.dk/jtc1/sc22/wg21/
61. http://gcc.gnu.org/contribute.html 61. http://gcc.gnu.org/ml/libstdc++/2001-01/msg00247.html
62. ../17_intro/contribute.html 62. http://gcc.gnu.org/gnatswrite.html
63. ../faq/index.html#2_4 63. http://gcc.gnu.org/ml/gcc/2000-10/msg00732.html
64. http://gcc.gnu.org/ml/libstdc++/1999/msg00080.html 64. http://gcc.gnu.org/contribute.html
65. http://gcc.gnu.org/ml/libstdc++/1999/msg00084.html 65. ../17_intro/contribute.html
66. http://www.sgi.com/Technology/STL/ 66. ../faq/index.html#2_4
67. ../ext/howto.html 67. http://gcc.gnu.org/ml/libstdc++/1999/msg00080.html
68. http://gcc.gnu.org/ml/libstdc++/1999-q3/msg00066.html 68. http://gcc.gnu.org/ml/libstdc++/1999/msg00084.html
69. http://gcc.gnu.org/libstdc++/17_intro/howto.html#3 69. http://www.sgi.com/Technology/STL/
70. http://gcc.gnu.org/libstdc++/23_containers/howto.html 70. ../ext/howto.html
71. http://www.ansi.org/ 71. http://gcc.gnu.org/ml/libstdc++/1999-q3/msg00066.html
72. http://webstore.ansi.org/ansidocstore/product.asp?sku=ISO%2FIEC+14882%2D1998 72. http://gcc.gnu.org/libstdc++/17_intro/howto.html#3
73. http://www.iso.ch/ 73. http://gcc.gnu.org/libstdc++/23_containers/howto.html
74. mailto:pme@sources.redhat.com 74. http://www.ansi.org/
75. mailto:gdr@gcc.gnu.org 75. http://webstore.ansi.org/ansidocstore/product.asp?sku=ISO%2FIEC+14882%2D1998
76. http://www.iso.ch/
77. mailto:pme@sources.redhat.com
78. mailto:gdr@gcc.gnu.org
libstdc++-v3/docs/html/install.html
...@@ -7,7 +7,7 @@ ...@@ -7,7 +7,7 @@
<META NAME="GENERATOR" CONTENT="vi and eight fingers"> <META NAME="GENERATOR" CONTENT="vi and eight fingers">
<TITLE>libstdc++-v3 Installation Instructions</TITLE> <TITLE>libstdc++-v3 Installation Instructions</TITLE>
<LINK REL=StyleSheet HREF="lib3styles.css"> <LINK REL=StyleSheet HREF="lib3styles.css">
<!-- $Id: install.html,v 1.1 2000/12/10 04:03:08 pme Exp $ --> <!-- $Id: install.html,v 1.2 2001/01/21 09:36:09 pme Exp $ -->
</HEAD> </HEAD>
<BODY> <BODY>
...@@ -150,7 +150,7 @@ ...@@ -150,7 +150,7 @@
<P><B>...with a gcc-2.9[67] snapshot</B> <P><B>...with a gcc-2.9[67] snapshot</B>
<P>Unpack the <EM>gccsrcdir</EM> and go into that directory. For <P>Unpack the <EM>gccsrcdir</EM> and go into that directory. For
X instance, <TT>gcc-2.95.2</TT> is a valid <EM>gccsrcdir</EM>. instance, <TT>gcc-2.95.2</TT> is a valid <EM>gccsrcdir</EM>.
Once in <EM>gccsrcdir</EM>, you'll need to rename the libstdc++-v3 Once in <EM>gccsrcdir</EM>, you'll need to rename the libstdc++-v3
directory which comes with that snapshot: directory which comes with that snapshot:
<PRE> <PRE>
...@@ -370,7 +370,7 @@ X instance, <TT>gcc-2.95.2</TT> is a valid <EM>gccsrcdir</EM>. ...@@ -370,7 +370,7 @@ X instance, <TT>gcc-2.95.2</TT> is a valid <EM>gccsrcdir</EM>.
Comments and suggestions are welcome, and may be sent to Comments and suggestions are welcome, and may be sent to
<A HREF="mailto:pme@sources.redhat.com">Phil Edwards</A> or <A HREF="mailto:pme@sources.redhat.com">Phil Edwards</A> or
<A HREF="mailto:gdr@gcc.gnu.org">Gabriel Dos Reis</A>. <A HREF="mailto:gdr@gcc.gnu.org">Gabriel Dos Reis</A>.
<BR> $Id: install.html,v 1.1 2000/12/10 04:03:08 pme Exp $ <BR> $Id: install.html,v 1.2 2001/01/21 09:36:09 pme Exp $
</EM></P> </EM></P>
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment