index.html: Explain libsupc++, mention 'long long' bugfixes on Solaris.
2001-11-07 Phil Edwards <pme@gcc.gnu.org> * docs/html/faq/index.html: Explain libsupc++, mention 'long long' bugfixes on Solaris. * docs/html/faq/index.txt: Regenerate. From-SVN: r46828
This commit is contained in:
parent
2a6f0eca17
commit
64ef1ee2d5
3 changed files with 448 additions and 315 deletions
|
@ -1,3 +1,9 @@
|
|||
2001-11-07 Phil Edwards <pme@gcc.gnu.org>
|
||||
|
||||
* docs/html/faq/index.html: Explain libsupc++, mention 'long long'
|
||||
bugfixes on Solaris.
|
||||
* docs/html/faq/index.txt: Regenerate.
|
||||
|
||||
2001-11-06 Phil Edwards <pme@gcc.gnu.org>
|
||||
|
||||
* acinclude.m4 (GLIBCPP_ENABLE_LONG_LONG): Run the test in
|
||||
|
|
|
@ -45,6 +45,7 @@ http://gcc.gnu.org/onlinedocs/libstdc++/faq/</a>.</p>
|
|||
<li><a href="#2_3">What is this CVS thing that you keep
|
||||
mentioning?</a>
|
||||
<li><a href="#2_4">How do I know if it works?</a>
|
||||
<li><a href="#2_5">This library is HUGE! And what's libsupc++?</a>
|
||||
</ol>
|
||||
|
||||
<li><a href="#3_0">Platform-Specific Issues</a>
|
||||
|
@ -53,6 +54,7 @@ http://gcc.gnu.org/onlinedocs/libstdc++/faq/</a>.</p>
|
|||
favorite compiler>?</a>
|
||||
<li><a href="#3_2">[removed]</a>
|
||||
<li><a href="#3_3">Building under DEC OSF kills the assembler</a>
|
||||
<li><a href="#3_4">I can't use 'long long' on Solaris</a>
|
||||
</ol>
|
||||
|
||||
<li><a href="#4_0">Known Bugs and Non-Bugs</a>
|
||||
|
@ -320,6 +322,56 @@ which is no longer available, thanks deja...-->
|
|||
<strong>please</strong> write up your idea and send it to the list!
|
||||
</p>
|
||||
|
||||
<hr>
|
||||
<h2><a name="2_5">2.4 This library is HUGE! And what's libsupc++?</a></h2>
|
||||
<p>Usually the size of libraries on disk isn't noticeable. When a
|
||||
link editor (or simply "linker") pulls things from a
|
||||
static archive library, only the necessary object files are copied
|
||||
into your executable, not the entire library. Unfortunately, even
|
||||
if you only need a single function or variable from an object file,
|
||||
the entire object file is extracted. (There's nothing unique to C++
|
||||
or libstdc++-v3 about this; it's just common behavior, given here
|
||||
for background reasons.)
|
||||
</p>
|
||||
<p>Some of the object files which make up libstdc++.a are rather large.
|
||||
If you create a statically-linked executable with
|
||||
<code> -static</code>, those large object files are suddenly part
|
||||
of your executable. Historically the best way around this was to
|
||||
only place a very few functions (often only a single one) in each
|
||||
source/object file; then extracting a single function is the same
|
||||
as extracting a single .o file. For libstdc++-v3 this is only
|
||||
possible to a certain extent; the object files in question contain
|
||||
template classes and template functions, pre-instantiated, and
|
||||
splitting those up causes severe maintenance headaches.
|
||||
</p>
|
||||
<p>It's not a bug, and it's not really a problem. Nevertheless, some
|
||||
people don't like it, so here are two pseudo-solutions:
|
||||
</p>
|
||||
<p>If the only functions from libstdc++.a which you need are language
|
||||
support functions (those listed in
|
||||
<a href="../18_support/howto.html">clause 18</a> of the standard,
|
||||
e.g., <code>new</code> and <code>delete</code>), then try linking
|
||||
against <code>libsupc++.a</code> (usually specifying
|
||||
<code>-lsupc++</code> when calling g++ for the final link step will
|
||||
do it). This library contains only those support routines, one per
|
||||
object file. But if you are using anything from the rest of the
|
||||
library, such as IOStreams or vectors, then you'll still need
|
||||
pieces from <code>libstdc++.a</code>.
|
||||
</p>
|
||||
<p>The second method is one we hope to incorporate into the library
|
||||
build process. Some platforms can place each function and variable
|
||||
into its own section in a .o file. The GNU linker can then perform
|
||||
garbage collection on unused sections; this reduces the situation
|
||||
to only copying needed functions into the executable, as before,
|
||||
but all happens automatically.
|
||||
</p>
|
||||
<p>Unfortunately the garbage collection in GNU ld is buggy; sections
|
||||
(corresponding to functions and variables) which <em>are</em> used
|
||||
are mistakenly removed, leading to horrible crashes when your
|
||||
executable starts up. For the time being, this feature is not used
|
||||
when building the library.
|
||||
</p>
|
||||
|
||||
<hr>
|
||||
<h1><a name="3_0">3.0 Platform-Specific Issues</a></h1>
|
||||
<h2><a name="3_1">3.1 Can libstdc++-v3 be used with <my
|
||||
|
@ -363,6 +415,18 @@ which is no longer available, thanks deja...-->
|
|||
these two pseudos would win praise and accolades from many.
|
||||
</p>
|
||||
|
||||
<hr>
|
||||
<h2><a name="3_4">3.4 I can't use 'long long' on Solaris</a></h2>
|
||||
<p>By default we try to support the C99 <code>long long</code> type.
|
||||
This requires that certain functions from your C library be present.
|
||||
</p>
|
||||
<p>Up through release 3.0.2 the tests performed were too general, and
|
||||
this feature was disabled when it did not need to be. The most
|
||||
commonly reported platform affected was Solaris.
|
||||
</p>
|
||||
<p>This has been fixed for 3.0.3 and onwards.
|
||||
</p>
|
||||
|
||||
<hr>
|
||||
<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
|
||||
|
@ -380,10 +444,9 @@ which is no longer available, thanks deja...-->
|
|||
specifically the part about configuring in a separate build directory,
|
||||
and how strongly recommended it is. Building in the source directory
|
||||
is fragile, is rarely tested, and tends to break, as in this case.
|
||||
Work has already gone into the source tree to make this less painful
|
||||
for the next release.
|
||||
This was fixed for 3.0.2.
|
||||
</p>
|
||||
<p><strong>Please do not report this as a bug. We know about it.</strong>
|
||||
<p><strong>Please do not report these as bugs. We know about them.</strong>
|
||||
Reporting this -- or any other problem that's already been fixed --
|
||||
hinders the development of GCC, because we have to take time to
|
||||
respond to your report. Thank you.
|
||||
|
|
|
@ -24,32 +24,34 @@
|
|||
2. [15][removed]
|
||||
3. [16]What is this CVS thing that you keep mentioning?
|
||||
4. [17]How do I know if it works?
|
||||
3. [18]Platform-Specific Issues
|
||||
1. [19]Can libstdc++-v3 be used with <my favorite compiler>?
|
||||
2. [20][removed]
|
||||
3. [21]Building under DEC OSF kills the assembler
|
||||
4. [22]Known Bugs and Non-Bugs
|
||||
1. [23]What works already?
|
||||
2. [24]Bugs in gcc/g++ (not libstdc++-v3)
|
||||
3. [25]Bugs in the C++ language/lib specification
|
||||
4. [26]Things in libstdc++ that look like bugs
|
||||
o [27]reopening a stream fails
|
||||
o [28]-Weffc++ complains too much
|
||||
o [29]"ambiguous overloads" after including an old-style
|
||||
5. [18]This library is HUGE! And what's libsupc++?
|
||||
3. [19]Platform-Specific Issues
|
||||
1. [20]Can libstdc++-v3 be used with <my favorite compiler>?
|
||||
2. [21][removed]
|
||||
3. [22]Building under DEC OSF kills the assembler
|
||||
4. [23]I can't use 'long long' on Solaris
|
||||
4. [24]Known Bugs and Non-Bugs
|
||||
1. [25]What works already?
|
||||
2. [26]Bugs in gcc/g++ (not libstdc++-v3)
|
||||
3. [27]Bugs in the C++ language/lib specification
|
||||
4. [28]Things in libstdc++ that look like bugs
|
||||
o [29]reopening a stream fails
|
||||
o [30]-Weffc++ complains too much
|
||||
o [31]"ambiguous overloads" after including an old-style
|
||||
header
|
||||
o [30]The g++-3 headers are not ours
|
||||
o [31]compilation errors from streambuf.h
|
||||
o [32]errors about *Cconcept and constraints in the STL...
|
||||
5. [33]Aw, that's easy to fix!
|
||||
5. [34]Miscellaneous
|
||||
1. [35]string::iterator is not char*; vector<T>::iterator is not
|
||||
o [32]The g++-3 headers are not ours
|
||||
o [33]compilation errors from streambuf.h
|
||||
o [34]errors about *Cconcept and constraints in the STL...
|
||||
5. [35]Aw, that's easy to fix!
|
||||
5. [36]Miscellaneous
|
||||
1. [37]string::iterator is not char*; vector<T>::iterator is not
|
||||
T*
|
||||
2. [36]What's next after libstdc++-v3?
|
||||
3. [37]What about the STL from SGI?
|
||||
4. [38]Extensions and Backward Compatibility
|
||||
5. [39][removed]
|
||||
6. [40]Is libstdc++-v3 thread-safe?
|
||||
7. [41]How do I get a copy of the ISO C++ Standard?
|
||||
2. [38]What's next after libstdc++-v3?
|
||||
3. [39]What about the STL from SGI?
|
||||
4. [40]Extensions and Backward Compatibility
|
||||
5. [41][removed]
|
||||
6. [42]Is libstdc++-v3 thread-safe?
|
||||
7. [43]How do I get a copy of the ISO C++ Standard?
|
||||
_________________________________________________________________
|
||||
|
||||
1.0 General Information
|
||||
|
@ -60,13 +62,13 @@
|
|||
project to implement the ISO 14882 Standard C++ library as described
|
||||
in chapters 17 through 27 and annex D. As the library reaches stable
|
||||
plateaus, it is captured in a snapshot and released. The current
|
||||
release is [42]the eleventh snapshot. For those who want to see
|
||||
release is [44]the eleventh snapshot. For those who want to 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
|
||||
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
|
||||
[43]design document.
|
||||
[45]design document.
|
||||
_________________________________________________________________
|
||||
|
||||
1.2 Why should I use libstdc++?
|
||||
|
@ -79,8 +81,8 @@
|
|||
|
||||
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
|
||||
development has recently been taken over by the [44]GCC team. All of
|
||||
the rapid development and near-legendary [45]portability that are the
|
||||
development has recently been taken over by the [46]GCC team. All of
|
||||
the rapid development and near-legendary [47]portability that are the
|
||||
hallmarks of an open-source project are being applied to libstdc++.
|
||||
|
||||
That means that all of the Standard classes and functions (such as
|
||||
|
@ -98,16 +100,16 @@
|
|||
|
||||
Development and discussion is held on the libstdc++ mailing list.
|
||||
Subscribing to the list, or searching the list archives, is open to
|
||||
everyone. You can read instructions for doing so on the [46]homepage.
|
||||
everyone. You can read instructions for doing so on the [48]homepage.
|
||||
If you have questions, ideas, code, or are just curious, sign up!
|
||||
_________________________________________________________________
|
||||
|
||||
1.4 How do I get libstdc++?
|
||||
|
||||
The eleventh (and latest) snapshot of libstdc++-v3 is [47]available
|
||||
The eleventh (and latest) snapshot of libstdc++-v3 is [49]available
|
||||
via ftp. The filename is libstdc++-2.92.tar.gz.
|
||||
|
||||
The [48]homepage has instructions for retrieving the latest CVS
|
||||
The [50]homepage has instructions for retrieving the latest CVS
|
||||
sources, and for browsing the CVS sources over the web.
|
||||
|
||||
The subset commonly known as the Standard Template Library (chapters
|
||||
|
@ -123,7 +125,7 @@
|
|||
|
||||
1.6 How do I contribute to the effort?
|
||||
|
||||
Here is [49]a page devoted to this topic. Subscribing to the mailing
|
||||
Here is [51]a page devoted to this topic. Subscribing to the mailing
|
||||
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.
|
||||
Contributions don't have to be in the form of source code; anybody who
|
||||
|
@ -158,11 +160,11 @@
|
|||
extracted into an updated utilities library, but nobody has stated
|
||||
such a project yet.
|
||||
|
||||
(The [50]Boost site houses free C++ libraries that do varying things,
|
||||
(The [52]Boost site houses free C++ libraries that do varying things,
|
||||
and happened to be started by members of the Standards Committee.
|
||||
Certain "useful stuff" classes will probably migrate there.)
|
||||
|
||||
For the bold and/or desperate, the [51]GCC FAQ describes where to find
|
||||
For the bold and/or desperate, the [53]GCC FAQ describes where to find
|
||||
the last libg++ source.
|
||||
_________________________________________________________________
|
||||
|
||||
|
@ -172,16 +174,16 @@
|
|||
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
|
||||
information is available on the homepage (including how to browse the
|
||||
list archives); to send to the list, use [52]libstdc++@gcc.gnu.org.
|
||||
list archives); to send to the list, use [54]libstdc++@gcc.gnu.org.
|
||||
|
||||
If you have a question that you think should be included here, or if
|
||||
you have a question about a question/answer here, contact [53]Phil
|
||||
Edwards or [54]Gabriel Dos Reis.
|
||||
you have a question about a question/answer here, contact [55]Phil
|
||||
Edwards or [56]Gabriel Dos Reis.
|
||||
_________________________________________________________________
|
||||
|
||||
1.9 What are the license terms for libstdc++-v3?
|
||||
|
||||
See [55]our license description for these and related questions.
|
||||
See [57]our license description for these and related questions.
|
||||
_________________________________________________________________
|
||||
|
||||
2.0 Installation
|
||||
|
@ -198,13 +200,13 @@
|
|||
* The GNU Autotools are needed if you are messing with the configury
|
||||
or makefiles.
|
||||
|
||||
The file [56]documentation.html provides a good overview of the steps
|
||||
The file [58]documentation.html provides a good overview of the steps
|
||||
necessary to build, install, and use the library. Instructions for
|
||||
configuring the library with new flags such as --enable-threads are
|
||||
there also, as well as patches and instructions for working with GCC
|
||||
2.95.
|
||||
|
||||
The top-level install.html and [57]RELEASE-NOTES files contain the
|
||||
The top-level install.html and [59]RELEASE-NOTES files contain the
|
||||
exact build and installation instructions. You may wish to browse
|
||||
those files over CVSweb ahead of time to get a feel for what's
|
||||
required. RELEASE-NOTES is located in the ".../docs/17_intro/"
|
||||
|
@ -221,8 +223,8 @@
|
|||
|
||||
The Concurrent Versions System is one of several revision control
|
||||
packages. It was selected for GNU projects because it's free (speech),
|
||||
free (beer), and very high quality. The [58]CVS entry in the GNU
|
||||
software catalogue has a better description as well as a [59]link to
|
||||
free (beer), and very high quality. The [60]CVS entry in the GNU
|
||||
software catalogue has a better description as well as a [61]link to
|
||||
the makers of CVS.
|
||||
|
||||
The "anonymous client checkout" feature of CVS is similar to anonymous
|
||||
|
@ -245,6 +247,54 @@
|
|||
If you find bugs in the testsuite programs themselves, or if you think
|
||||
of a new test program that should be added to the suite, please write
|
||||
up your idea and send it to the list!
|
||||
_________________________________________________________________
|
||||
|
||||
2.4 This library is HUGE! And what's libsupc++?
|
||||
|
||||
Usually the size of libraries on disk isn't noticeable. When a link
|
||||
editor (or simply "linker") pulls things from a static archive
|
||||
library, only the necessary object files are copied into your
|
||||
executable, not the entire library. Unfortunately, even if you only
|
||||
need a single function or variable from an object file, the entire
|
||||
object file is extracted. (There's nothing unique to C++ or
|
||||
libstdc++-v3 about this; it's just common behavior, given here for
|
||||
background reasons.)
|
||||
|
||||
Some of the object files which make up libstdc++.a are rather large.
|
||||
If you create a statically-linked executable with -static, those large
|
||||
object files are suddenly part of your executable. Historically the
|
||||
best way around this was to only place a very few functions (often
|
||||
only a single one) in each source/object file; then extracting a
|
||||
single function is the same as extracting a single .o file. For
|
||||
libstdc++-v3 this is only possible to a certain extent; the object
|
||||
files in question contain template classes and template functions,
|
||||
pre-instantiated, and splitting those up causes severe maintenance
|
||||
headaches.
|
||||
|
||||
It's not a bug, and it's not really a problem. Nevertheless, some
|
||||
people don't like it, so here are two pseudo-solutions:
|
||||
|
||||
If the only functions from libstdc++.a which you need are language
|
||||
support functions (those listed in [62]clause 18 of the standard,
|
||||
e.g., new and delete), then try linking against libsupc++.a (usually
|
||||
specifying -lsupc++ when calling g++ for the final link step will do
|
||||
it). This library contains only those support routines, one per object
|
||||
file. But if you are using anything from the rest of the library, such
|
||||
as IOStreams or vectors, then you'll still need pieces from
|
||||
libstdc++.a.
|
||||
|
||||
The second method is one we hope to incorporate into the library build
|
||||
process. Some platforms can place each function and variable into its
|
||||
own section in a .o file. The GNU linker can then perform garbage
|
||||
collection on unused sections; this reduces the situation to only
|
||||
copying needed functions into the executable, as before, but all
|
||||
happens automatically.
|
||||
|
||||
Unfortunately the garbage collection in GNU ld is buggy; sections
|
||||
(corresponding to functions and variables) which are used are
|
||||
mistakenly removed, leading to horrible crashes when your executable
|
||||
starts up. For the time being, this feature is not used when building
|
||||
the library.
|
||||
_________________________________________________________________
|
||||
|
||||
3.0 Platform-Specific Issues
|
||||
|
@ -281,9 +331,21 @@
|
|||
install GNU as and arrange for the GCC build to use it (or merge the
|
||||
sources and build it during the bootstrap).
|
||||
|
||||
Anyone who [60]knows the DEC assembler well enough to provide the
|
||||
Anyone who [63]knows the DEC assembler well enough to provide the
|
||||
equivalent of these two pseudos would win praise and accolades from
|
||||
many.
|
||||
_________________________________________________________________
|
||||
|
||||
3.4 I can't use 'long long' on Solaris
|
||||
|
||||
By default we try to support the C99 long long type. This requires
|
||||
that certain functions from your C library be present.
|
||||
|
||||
Up through release 3.0.2 the tests performed were too general, and
|
||||
this feature was disabled when it did not need to be. The most
|
||||
commonly reported platform affected was Solaris.
|
||||
|
||||
This has been fixed for 3.0.3 and onwards.
|
||||
_________________________________________________________________
|
||||
|
||||
4.0 Known Bugs and Non-Bugs
|
||||
|
@ -297,14 +359,13 @@
|
|||
include/Makefile, resulting in files like gthr.h and gthr-single.h not
|
||||
being found.
|
||||
|
||||
Please read [61]the configuration instructions for GCC, specifically
|
||||
Please read [64]the configuration instructions for GCC, specifically
|
||||
the part about configuring in a separate build directory, and how
|
||||
strongly recommended it is. Building in the source directory is
|
||||
fragile, is rarely tested, and tends to break, as in this case. Work
|
||||
has already gone into the source tree to make this less painful for
|
||||
the next release.
|
||||
fragile, is rarely tested, and tends to break, as in this case. This
|
||||
was fixed for 3.0.2.
|
||||
|
||||
Please do not report this as a bug. We know about it. Reporting this
|
||||
Please do not report these as bugs. We know about them. Reporting this
|
||||
-- or any other problem that's already been fixed -- hinders the
|
||||
development of GCC, because we have to take time to respond to your
|
||||
report. Thank you.
|
||||
|
@ -350,17 +411,17 @@ New:
|
|||
|
||||
4.3 Bugs in the C++ language/lib specification
|
||||
|
||||
Yes, unfortunately, there are some. In a [62]message to the list,
|
||||
Yes, unfortunately, there are some. In a [65]message to the list,
|
||||
Nathan Myers announced that he has started a list of problems in the
|
||||
ISO C++ Standard itself, especially with regard to the chapters that
|
||||
concern the library. The list itself is [63]posted on his website.
|
||||
concern the library. The list itself is [66]posted on his website.
|
||||
Developers who are having problems interpreting the Standard may wish
|
||||
to consult his notes.
|
||||
|
||||
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
|
||||
public list of the library defects is occasionally published [64]here.
|
||||
Some of these have resulted in [65]code changes.
|
||||
public list of the library defects is occasionally published [67]here.
|
||||
Some of these have resulted in [68]code changes.
|
||||
_________________________________________________________________
|
||||
|
||||
4.4 Things in libstdc++ that look like bugs
|
||||
|
@ -393,7 +454,7 @@ New:
|
|||
state on the previous file. The reason is that the state flags are not
|
||||
cleared on a successful call to open(). The standard unfortunately did
|
||||
not specify behavior in this case, and to everybody's great sorrow,
|
||||
the [66]proposed LWG resolution (see DR #22) is to leave the flags
|
||||
the [69]proposed LWG resolution (see DR #22) is to leave the flags
|
||||
unchanged. You must insert a call to fs.clear() between the calls to
|
||||
close() and open(), and then everything will work like we all expect
|
||||
it to work.
|
||||
|
@ -403,14 +464,14 @@ New:
|
|||
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 [67]sums things up here.
|
||||
Nathan Myers [70]sums things up here.
|
||||
|
||||
The g++-3 headers are not ours
|
||||
|
||||
If you have found an extremely broken header file which is causing
|
||||
problems for you, look carefully before submitting a "high" priority
|
||||
bug report (which you probably shouldn't do anyhow; see the last
|
||||
paragraph of the page describing [68]the GCC bug database).
|
||||
paragraph of the page describing [71]the GCC bug database).
|
||||
|
||||
If the headers are in ${prefix}/include/g++-3, then you are using the
|
||||
old libstdc++-v2 library, which is nonstandard and unmaintained. Do
|
||||
|
@ -418,7 +479,7 @@ New:
|
|||
|
||||
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
|
||||
may be too confusing, but [69]the question has not yet been decided.
|
||||
may be too confusing, but [72]the question has not yet been decided.
|
||||
|
||||
glibc If you're on a GNU/Linux system and have just upgraded to glibc
|
||||
2.2, but are still using gcc 2.95.2, then you should have read the
|
||||
|
@ -431,7 +492,7 @@ type has changed in glibc 2.2. The patch is at
|
|||
http://clisp.cons.org/~haible/gccinclude-glibc-2.2-compat.diff
|
||||
|
||||
|
||||
Note that 2.95.x shipped with the [70]old v2 library which is no
|
||||
Note that 2.95.x shipped with the [73]old v2 library which is no
|
||||
longer maintained. Also note that gcc 2.95.3 fixes this problem, but
|
||||
requires a separate patch for libstdc++-v3.
|
||||
|
||||
|
@ -444,23 +505,23 @@ http://clisp.cons.org/~haible/gccinclude-glibc-2.2-compat.diff
|
|||
visibility, or you just plain forgot, etc).
|
||||
|
||||
More information, including how to optionally enable/disable the
|
||||
checks, is available [71]here.
|
||||
checks, is available [74]here.
|
||||
_________________________________________________________________
|
||||
|
||||
4.5 Aw, that's easy to fix!
|
||||
|
||||
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
|
||||
[72]submitting patches that covers the procedure, but for libstdc++
|
||||
[75]submitting patches that covers the procedure, but for libstdc++
|
||||
you should also send the patch to our mailing list in addition to the
|
||||
GCC patches mailing list. The libstdc++ [73]contributors' page also
|
||||
GCC patches mailing list. The libstdc++ [76]contributors' page also
|
||||
talks about how to submit patches.
|
||||
|
||||
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
|
||||
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
|
||||
caught immediately by the [74]testsuite -- but only if such a test
|
||||
caught immediately by the [77]testsuite -- but only if such a test
|
||||
exists.
|
||||
_________________________________________________________________
|
||||
|
||||
|
@ -494,7 +555,7 @@ http://clisp.cons.org/~haible/gccinclude-glibc-2.2-compat.diff
|
|||
libstdc++. Some of that is already happening, see 4.2. Some of
|
||||
those changes are being predicted by the library maintainers, and
|
||||
we add code to the library based on what the current proposed
|
||||
resolution specifies. Those additions are listed in [75]the
|
||||
resolution specifies. Those additions are listed in [78]the
|
||||
extensions page.
|
||||
2. Performance tuning. Lots of performance tuning. This too is
|
||||
already underway for post-3.0 releases, starting with memory
|
||||
|
@ -510,13 +571,13 @@ http://clisp.cons.org/~haible/gccinclude-glibc-2.2-compat.diff
|
|||
type from C99.) Bugfixes and rewrites (to improve or fix thread
|
||||
safety, for instance) will of course be a continuing task.
|
||||
|
||||
[76]This question about the next libstdc++ prompted some brief but
|
||||
interesting [77]speculation.
|
||||
[79]This question about the next libstdc++ prompted some brief but
|
||||
interesting [80]speculation.
|
||||
_________________________________________________________________
|
||||
|
||||
5.3 What about the STL from SGI?
|
||||
|
||||
The [78]STL from SGI, version 3.3, was the most recent merge of the
|
||||
The [81]STL from SGI, version 3.3, was the most recent merge of the
|
||||
STL codebase. The code in libstdc++ contains many fixes and changes,
|
||||
and it is very likely that the SGI code is no longer under active
|
||||
development. We expect that no future merges will take place.
|
||||
|
@ -537,7 +598,7 @@ http://clisp.cons.org/~haible/gccinclude-glibc-2.2-compat.diff
|
|||
#include <ext/hash_map>
|
||||
|
||||
|
||||
Extensions to the library have [79]their own page.
|
||||
Extensions to the library have [82]their own page.
|
||||
_________________________________________________________________
|
||||
|
||||
5.5 [removed]
|
||||
|
@ -585,8 +646,8 @@ a
|
|||
both read and write access to objects; do not assume that two threads
|
||||
may read a shared standard container at the same time.
|
||||
|
||||
See chapters [80]17 (library introduction), [81]23 (containers), and
|
||||
[82]27 (I/O) for more information.
|
||||
See chapters [83]17 (library introduction), [84]23 (containers), and
|
||||
[85]27 (I/O) for more information.
|
||||
_________________________________________________________________
|
||||
|
||||
5.7 How do I get a copy of the ISO C++ Standard?
|
||||
|
@ -597,16 +658,16 @@ a
|
|||
their two-meeting commitment for voting rights, may get a copy of the
|
||||
standard from their respective national standards organization. In the
|
||||
USA, this national standards organization is ANSI and their website is
|
||||
right [83]here. (And if you've already registered with them, clicking
|
||||
this link will take you to directly to the place where you can [84]buy
|
||||
right [86]here. (And if you've already registered with them, clicking
|
||||
this link will take you to directly to the place where you can [87]buy
|
||||
the standard on-line.
|
||||
|
||||
Who is your country's member body? Visit the [85]ISO homepage and find
|
||||
Who is your country's member body? Visit the [88]ISO homepage and find
|
||||
out!
|
||||
_________________________________________________________________
|
||||
|
||||
See [86]license.html for copying conditions. Comments and suggestions
|
||||
are welcome, and may be sent to [87]the libstdc++ mailing list.
|
||||
See [89]license.html for copying conditions. Comments and suggestions
|
||||
are welcome, and may be sent to [90]the libstdc++ mailing list.
|
||||
|
||||
References
|
||||
|
||||
|
@ -627,73 +688,76 @@ References
|
|||
15. ../faq/index.html#2_2
|
||||
16. ../faq/index.html#2_3
|
||||
17. ../faq/index.html#2_4
|
||||
18. ../faq/index.html#3_0
|
||||
19. ../faq/index.html#3_1
|
||||
20. ../faq/index.html#3_2
|
||||
21. ../faq/index.html#3_3
|
||||
22. ../faq/index.html#4_0
|
||||
23. ../faq/index.html#4_1
|
||||
24. ../faq/index.html#4_2
|
||||
25. ../faq/index.html#4_3
|
||||
26. ../faq/index.html#4_4
|
||||
27. ../faq/index.html#4_4_iostreamclear
|
||||
28. ../faq/index.html#4_4_Weff
|
||||
29. ../faq/index.html#4_4_rel_ops
|
||||
30. ../faq/index.html#4_4_interface
|
||||
31. ../faq/index.html#4_4_glibc
|
||||
32. ../faq/index.html#4_4_checks
|
||||
33. ../faq/index.html#4_5
|
||||
34. ../faq/index.html#5_0
|
||||
35. ../faq/index.html#5_1
|
||||
36. ../faq/index.html#5_2
|
||||
37. ../faq/index.html#5_3
|
||||
38. ../faq/index.html#5_4
|
||||
39. ../faq/index.html#5_5
|
||||
40. ../faq/index.html#5_6
|
||||
41. ../faq/index.html#5_7
|
||||
42. http://gcc.gnu.org/libstdc++/download.html
|
||||
43. ../17_intro/DESIGN
|
||||
44. http://gcc.gnu.org/
|
||||
45. http://gcc.gnu.org/gcc-2.95/buildstat.html
|
||||
46. http://gcc.gnu.org/libstdc++/
|
||||
47. http://gcc.gnu.org/libstdc++/download.html
|
||||
18. ../faq/index.html#2_5
|
||||
19. ../faq/index.html#3_0
|
||||
20. ../faq/index.html#3_1
|
||||
21. ../faq/index.html#3_2
|
||||
22. ../faq/index.html#3_3
|
||||
23. ../faq/index.html#3_4
|
||||
24. ../faq/index.html#4_0
|
||||
25. ../faq/index.html#4_1
|
||||
26. ../faq/index.html#4_2
|
||||
27. ../faq/index.html#4_3
|
||||
28. ../faq/index.html#4_4
|
||||
29. ../faq/index.html#4_4_iostreamclear
|
||||
30. ../faq/index.html#4_4_Weff
|
||||
31. ../faq/index.html#4_4_rel_ops
|
||||
32. ../faq/index.html#4_4_interface
|
||||
33. ../faq/index.html#4_4_glibc
|
||||
34. ../faq/index.html#4_4_checks
|
||||
35. ../faq/index.html#4_5
|
||||
36. ../faq/index.html#5_0
|
||||
37. ../faq/index.html#5_1
|
||||
38. ../faq/index.html#5_2
|
||||
39. ../faq/index.html#5_3
|
||||
40. ../faq/index.html#5_4
|
||||
41. ../faq/index.html#5_5
|
||||
42. ../faq/index.html#5_6
|
||||
43. ../faq/index.html#5_7
|
||||
44. http://gcc.gnu.org/libstdc++/download.html
|
||||
45. ../17_intro/DESIGN
|
||||
46. http://gcc.gnu.org/
|
||||
47. http://gcc.gnu.org/gcc-2.95/buildstat.html
|
||||
48. http://gcc.gnu.org/libstdc++/
|
||||
49. ../17_intro/contribute.html
|
||||
50. http://www.boost.org/
|
||||
51. http://gcc.gnu.org/fom_serv/cache/33.html
|
||||
52. mailto:libstdc++@gcc.gnu.org
|
||||
53. mailto:pme@gcc.gnu.org
|
||||
54. mailto:gdr@gcc.gnu.org
|
||||
55. ../17_intro/license.html
|
||||
56. ../documentation.html
|
||||
57. ../17_intro/RELEASE-NOTES
|
||||
58. http://www.gnu.org/software/cvs/cvs.html
|
||||
59. http://www.cvshome.org/
|
||||
60. http://gcc.gnu.org/ml/libstdc++/2000-12/msg00279.html
|
||||
61. http://gcc.gnu.org/install/configure.html
|
||||
62. http://gcc.gnu.org/ml/libstdc++/1998/msg00006.html
|
||||
63. http://www.cantrip.org/draft-bugs.txt
|
||||
64. http://anubis.dkuug.dk/jtc1/sc22/wg21/
|
||||
65. ../faq/index.html#5_2
|
||||
66. ../ext/howto.html#5
|
||||
67. http://gcc.gnu.org/ml/libstdc++/2001-01/msg00247.html
|
||||
68. http://gcc.gnu.org/gnatswrite.html
|
||||
69. http://gcc.gnu.org/ml/gcc/2000-10/msg00732.html
|
||||
70. ../faq/index.html#4_4_interface
|
||||
71. ../19_diagnostics/howto.html#3
|
||||
72. http://gcc.gnu.org/contribute.html
|
||||
73. ../17_intro/contribute.html
|
||||
74. ../faq/index.html#2_4
|
||||
75. ../ext/howto.html#5
|
||||
76. http://gcc.gnu.org/ml/libstdc++/1999/msg00080.html
|
||||
77. http://gcc.gnu.org/ml/libstdc++/1999/msg00084.html
|
||||
78. http://www.sgi.com/Technology/STL/
|
||||
79. ../ext/howto.html
|
||||
80. ../17_intro/howto.html#3
|
||||
81. ../23_containers/howto.html#3
|
||||
82. ../27_io/howto.html#9
|
||||
83. http://www.ansi.org/
|
||||
84. http://webstore.ansi.org/ansidocstore/product.asp?sku=ISO%2FIEC+14882%2D1998
|
||||
85. http://www.iso.ch/
|
||||
86. ../17_intro/license.html
|
||||
87. mailto:libstdc++@gcc.gnu.org
|
||||
49. http://gcc.gnu.org/libstdc++/download.html
|
||||
50. http://gcc.gnu.org/libstdc++/
|
||||
51. ../17_intro/contribute.html
|
||||
52. http://www.boost.org/
|
||||
53. http://gcc.gnu.org/fom_serv/cache/33.html
|
||||
54. mailto:libstdc++@gcc.gnu.org
|
||||
55. mailto:pme@gcc.gnu.org
|
||||
56. mailto:gdr@gcc.gnu.org
|
||||
57. ../17_intro/license.html
|
||||
58. ../documentation.html
|
||||
59. ../17_intro/RELEASE-NOTES
|
||||
60. http://www.gnu.org/software/cvs/cvs.html
|
||||
61. http://www.cvshome.org/
|
||||
62. ../18_support/howto.html
|
||||
63. http://gcc.gnu.org/ml/libstdc++/2000-12/msg00279.html
|
||||
64. http://gcc.gnu.org/install/configure.html
|
||||
65. http://gcc.gnu.org/ml/libstdc++/1998/msg00006.html
|
||||
66. http://www.cantrip.org/draft-bugs.txt
|
||||
67. http://anubis.dkuug.dk/jtc1/sc22/wg21/
|
||||
68. ../faq/index.html#5_2
|
||||
69. ../ext/howto.html#5
|
||||
70. http://gcc.gnu.org/ml/libstdc++/2001-01/msg00247.html
|
||||
71. http://gcc.gnu.org/gnatswrite.html
|
||||
72. http://gcc.gnu.org/ml/gcc/2000-10/msg00732.html
|
||||
73. ../faq/index.html#4_4_interface
|
||||
74. ../19_diagnostics/howto.html#3
|
||||
75. http://gcc.gnu.org/contribute.html
|
||||
76. ../17_intro/contribute.html
|
||||
77. ../faq/index.html#2_4
|
||||
78. ../ext/howto.html#5
|
||||
79. http://gcc.gnu.org/ml/libstdc++/1999/msg00080.html
|
||||
80. http://gcc.gnu.org/ml/libstdc++/1999/msg00084.html
|
||||
81. http://www.sgi.com/Technology/STL/
|
||||
82. ../ext/howto.html
|
||||
83. ../17_intro/howto.html#3
|
||||
84. ../23_containers/howto.html#3
|
||||
85. ../27_io/howto.html#9
|
||||
86. http://www.ansi.org/
|
||||
87. http://webstore.ansi.org/ansidocstore/product.asp?sku=ISO%2FIEC+14882%2D1998
|
||||
88. http://www.iso.ch/
|
||||
89. ../17_intro/license.html
|
||||
90. mailto:libstdc++@gcc.gnu.org
|
||||
|
|
Loading…
Add table
Add a link
Reference in a new issue