configopts.html: Describe recent options.
2001-12-19 Phil Edwards <pme@gcc.gnu.org> * docs/html/configopts.html: Describe recent options. * docs/html/documentation.html: Point to new doxygen tarballs. * docs/html/install.html: Brief updates. * docs/html/17_intro/RELEASE-NOTES: Remove weird control character. * docs/html/ext/howto.html: Fix typos, describe filebuf::fd(). * docs/html/faq/index.html: Update for 3.0.95. * docs/html/faq/index.txt: Regenerate. From-SVN: r48184
This commit is contained in:
parent
366f6a5273
commit
572cd73ac9
|
@ -1,3 +1,13 @@
|
|||
2001-12-19 Phil Edwards <pme@gcc.gnu.org>
|
||||
|
||||
* docs/html/configopts.html: Describe recent options.
|
||||
* docs/html/documentation.html: Point to new doxygen tarballs.
|
||||
* docs/html/install.html: Brief updates.
|
||||
* docs/html/17_intro/RELEASE-NOTES: Remove weird control character.
|
||||
* docs/html/ext/howto.html: Fix typos, describe filebuf::fd().
|
||||
* docs/html/faq/index.html: Update for 3.0.95.
|
||||
* docs/html/faq/index.txt: Regenerate.
|
||||
|
||||
2001-12-19 David Billinghurst <David.Billinghurst@riotinto.com>
|
||||
|
||||
libstdc++-v3/5148
|
||||
|
|
Binary file not shown.
|
@ -135,19 +135,9 @@ options</a></h1>
|
|||
</p>
|
||||
|
||||
<dt><code>--enable-threads=LIB </code>
|
||||
<dd><p>Select a threading library. As of libstdc++-v3 snapshot 2.91,
|
||||
the choices are:
|
||||
'yes' for some kind of default (hmmmmm);
|
||||
'decosf1', 'irix', 'mach', 'os2', 'posix'/'pthreads'
|
||||
(same thing),
|
||||
'solaris', 'win32', 'dce', or 'vxworks' to select the
|
||||
corresponding interface;
|
||||
and 'single', 'no', or 'none' for the null-case,
|
||||
single-threaded library.
|
||||
</p>
|
||||
<p>All of this is currently undergoing a lot of changes. As of
|
||||
2.91, 'single' and 'posix' are the only implemented
|
||||
models. Default is single.
|
||||
<dd><p>Select a threading library. A full description is given in the
|
||||
general <a href="http://gcc.gnu.org/install/configure.html">compiler
|
||||
configuration instructions</a>.
|
||||
</p>
|
||||
|
||||
<dt><code>--enable-version-specific-runtime-libs </code>
|
||||
|
@ -204,6 +194,14 @@ options</a></h1>
|
|||
porting steps, but builds only a subset of what is required by
|
||||
ISO. By default, this option is on.
|
||||
</p>
|
||||
|
||||
<dt><code>--enable-concept-checks </code>
|
||||
<dd><p>This turns on additional compile-time checks for instantiated
|
||||
library templates, in the form of specialized templates,
|
||||
<a href="19_diagnostics/howto.html#3">described here</a>. They
|
||||
can help users discover when they break the rules of the STL, before
|
||||
their programs run.
|
||||
</p>
|
||||
</dl>
|
||||
</p>
|
||||
<p>Return <a href="#top">to the top of the page</a> or
|
||||
|
|
|
@ -20,19 +20,25 @@
|
|||
using the Doxygen tool. These are useful for examining the signatures
|
||||
of public member functions for the library classes, etc.
|
||||
</p>
|
||||
<p>
|
||||
The latest collection is for the GCC 3.0 release,
|
||||
<p>One collection is for the GCC 3.0 release,
|
||||
<code>libstdc++-doxygen-3.0.tar.gz</code> (3.8MB),
|
||||
<a href="libstdc++-doxygen-3.0/index.html">viewable online</a>.
|
||||
The collection is also available in the libstdc++ snapshots directory at
|
||||
<code><URL:ftp://gcc.gnu.org/pub/gcc/libstdc++/></code>. You will
|
||||
almost certainly need to use one of the
|
||||
The latest collection is for the libstdc++ 3.0.95 snapshot release,
|
||||
<a href="libstdc++-doxygen-USERS-3.0.95/index.html">viewable online</a>.
|
||||
Other collections for 3.0.95 exist on the FTP sites, but are not
|
||||
viewable online.
|
||||
</p>
|
||||
<p>The collections are available in the libstdc++ snapshots directory at
|
||||
<code><URL:ftp://gcc.gnu.org/pub/gcc/libstdc++/doxygen/></code>.
|
||||
You will almost certainly need to use one of the
|
||||
<a href="http://gcc.gnu.org/mirrors.html">mirror sites</a> to download
|
||||
the tarball. After unpacking, simply load
|
||||
libstdc++-doxygen-3.0/index.html <!-- also update this date -->
|
||||
in a browser. Feedback (and additional documentation!) is welcome.
|
||||
libstdc++-doxygen-*/index.html
|
||||
into a browser. Feedback (and additional documentation!) is welcome.
|
||||
</p>
|
||||
<p>With 3.0.95, an initial set of man pages are also available in the same
|
||||
directory as the doxygen collections. Start with <code>Intro(3)</code>.
|
||||
</p>
|
||||
<!-- another paragraph here for post-release collections -->
|
||||
|
||||
<hr>
|
||||
<h2><a name="2">Configuring, Building, Installing</a></h2>
|
||||
|
|
|
@ -118,7 +118,7 @@
|
|||
<li>The extensions added by SGI are so numerous that they have
|
||||
<a href="sgiexts.html">their own page</a>. Since the SGI STL is no
|
||||
longer actively maintained, we will try and keep this code working
|
||||
ourselves.
|
||||
ourselves.</li>
|
||||
<li><code>filebuf</code>s have another ctor with this signature:<br>
|
||||
<code>basic_filebuf(__c_file_type*, ios_base::openmode, int_type);</code>
|
||||
<br>This comes in very handy in a number of places, such as
|
||||
|
@ -131,10 +131,18 @@
|
|||
<li><code>ios_base::openmode M </code>
|
||||
// same as all the other uses of openmode
|
||||
<li><code>int_type B </code>
|
||||
// buffer size, defaults to BUFSIZ
|
||||
// buffer size, defaults to BUFSIZ if not specified
|
||||
</ul>
|
||||
For those wanting to use file descriptors instead of FILE*'s, I
|
||||
invite you to contemplate the mysteries of C's <code>fdopen()</code>.
|
||||
</li>
|
||||
<li>In library snapshot 3.0.95 and later, <code>filebuf</code>s bring
|
||||
back an old extension: the <code>fd()</code> member function. The
|
||||
integer returned from this function can be used for whatever file
|
||||
descriptors can be used for on your platform. Naturally, the
|
||||
library cannot track what you do on your own with a file descriptor,
|
||||
so if you perform any I/O directly, don't expect the library to be
|
||||
aware of it.
|
||||
</ul>
|
||||
</p>
|
||||
<p>Return <a href="#top">to top of page</a> or
|
||||
|
@ -188,8 +196,8 @@
|
|||
program: when your program's std::vector<int> gets cut in half
|
||||
and frees a bunch of its storage, that memory can be reused by the
|
||||
private std::list<WonkyWidget> brought in from a KDE library
|
||||
that you linked against. And we don't have to call operator's new and
|
||||
delete to pass the memory on, ether, which is a speed bonus.
|
||||
that you linked against. And we don't have to call operators new and
|
||||
delete to pass the memory on, either, which is a speed bonus.
|
||||
<strong>BUT</strong>...
|
||||
</p>
|
||||
<p>What about threads? No problem: in a threadsafe environment, the
|
||||
|
|
|
@ -7,7 +7,7 @@
|
|||
<link rel="StyleSheet" href="../lib3styles.css">
|
||||
<!--
|
||||
** 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.
|
||||
-->
|
||||
</head>
|
||||
<body>
|
||||
|
@ -105,7 +105,7 @@ http://gcc.gnu.org/onlinedocs/libstdc++/faq/</a>.</p>
|
|||
library reaches stable plateaus, it is captured in a snapshot
|
||||
and released. The current release is
|
||||
<a href="http://gcc.gnu.org/libstdc++/download.html">the
|
||||
eleventh snapshot</a>. For those who want to see exactly how
|
||||
twelfth snapshot</a>. 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).
|
||||
|
@ -161,9 +161,9 @@ http://gcc.gnu.org/onlinedocs/libstdc++/faq/</a>.</p>
|
|||
|
||||
<hr>
|
||||
<h2><a name="1_4">1.4 How do I get libstdc++?</a></h2>
|
||||
<p>The eleventh (and latest) snapshot of libstdc++-v3 is
|
||||
<p>The twelfth (and latest) snapshot of libstdc++-v3 is
|
||||
<a href="http://gcc.gnu.org/libstdc++/download.html">available via
|
||||
ftp</a>. The filename is libstdc++-2.92.tar.gz.
|
||||
ftp</a>.
|
||||
</p>
|
||||
<p>The <a href="http://gcc.gnu.org/libstdc++/">homepage</a>
|
||||
has instructions for retrieving the latest CVS sources, and for
|
||||
|
@ -468,27 +468,25 @@ which is no longer available, thanks deja...-->
|
|||
<pre>
|
||||
New:
|
||||
---
|
||||
- preliminary doxygen documentation has been added. Running "make
|
||||
doxygen" in the libstdc++-v3 build directory will generate HTML
|
||||
documentation that can be used to cross-reference names and files in
|
||||
the library.
|
||||
- a dejagnu based testing framework has been added
|
||||
- a new implementation of the concept checking code has been ported
|
||||
from the boost libraries.
|
||||
- support for -fno-exceptions has been added
|
||||
- stdexcept was re-written
|
||||
- using deprecated or antiquated headers now gives a warning
|
||||
- the stdio interface to iostreams has been tweaked, and now works
|
||||
with synchronized c/c++ io
|
||||
- new libsupc++ routines implementing the IA-64 C++ ABI.
|
||||
- HPUX configuration files
|
||||
- support for AIX added
|
||||
- a lot of bugs were fixed.
|
||||
- preliminary named locales implemented
|
||||
- portability improvements made to generation of <limits>
|
||||
- speedups to improve configuration time.
|
||||
- DJGPP support added.
|
||||
- support for dlopening shared libstdc++
|
||||
- add S390, m68k, x86-64 support.
|
||||
- doxygen documentation has been extended, including man pages.
|
||||
- verbose terminate handling has been added.
|
||||
- some libsupc++ tweaks
|
||||
- warnings for deprecated headers now active.
|
||||
- dejagnu testsuite preliminary documentation.
|
||||
- dejagnu testsuite default.
|
||||
- dejagnu testsuite cross compiler, multilib safe.
|
||||
- long long iostreams on by default, rework of ISO C99 support.
|
||||
- iterator re-write and testsuites.
|
||||
- container testsuites.
|
||||
- allocator revamp and testsuites.
|
||||
- more concept-checking work.
|
||||
- basic_string optimization and MT fixes.
|
||||
- new limits implementation.
|
||||
- update -fno-exceptions code, verify it works.
|
||||
- full named locale support fpr all facets, choice of gnu,
|
||||
ieee_1003.1-200x (POSIX 2), or generic models. Full support depends
|
||||
on target OS and underlying "C" library support.
|
||||
</pre>
|
||||
|
||||
|
||||
|
@ -501,8 +499,9 @@ New:
|
|||
the GCC mailing lists.
|
||||
</p>
|
||||
<ul>
|
||||
<li>As of 2.91, these bugs have all been fixed. We look forward
|
||||
to new ones, well, not exactly...
|
||||
<li>As of 3.0.95, those bugs have all been fixed. We look forward
|
||||
to new ones, well, not exactly... Existing bugs are listed in
|
||||
the BUGS file, and the GCC GNATS database.
|
||||
</ul>
|
||||
|
||||
<hr>
|
||||
|
|
|
@ -62,7 +62,7 @@
|
|||
The GNU Standard C++ Library v3 is an ongoing 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 [45]the eleventh
|
||||
a snapshot and released. The current release is [45]the twelfth
|
||||
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
|
||||
|
@ -111,8 +111,8 @@
|
|||
|
||||
1.4 How do I get libstdc++?
|
||||
|
||||
The eleventh (and latest) snapshot of libstdc++-v3 is [51]available
|
||||
via ftp. The filename is libstdc++-2.92.tar.gz.
|
||||
The twelfth (and latest) snapshot of libstdc++-v3 is [51]available via
|
||||
ftp.
|
||||
|
||||
The [52]homepage has instructions for retrieving the latest CVS
|
||||
sources, and for browsing the CVS sources over the web.
|
||||
|
@ -381,27 +381,25 @@
|
|||
for the latest snapshot.
|
||||
New:
|
||||
---
|
||||
- preliminary doxygen documentation has been added. Running "make
|
||||
doxygen" in the libstdc++-v3 build directory will generate HTML
|
||||
documentation that can be used to cross-reference names and files in
|
||||
the library.
|
||||
- a dejagnu based testing framework has been added
|
||||
- a new implementation of the concept checking code has been ported
|
||||
from the boost libraries.
|
||||
- support for -fno-exceptions has been added
|
||||
- stdexcept was re-written
|
||||
- using deprecated or antiquated headers now gives a warning
|
||||
- the stdio interface to iostreams has been tweaked, and now works
|
||||
with synchronized c/c++ io
|
||||
- new libsupc++ routines implementing the IA-64 C++ ABI.
|
||||
- HPUX configuration files
|
||||
- support for AIX added
|
||||
- a lot of bugs were fixed.
|
||||
- preliminary named locales implemented
|
||||
- portability improvements made to generation of <limits>
|
||||
- speedups to improve configuration time.
|
||||
- DJGPP support added.
|
||||
- support for dlopening shared libstdc++
|
||||
- add S390, m68k, x86-64 support.
|
||||
- doxygen documentation has been extended, including man pages.
|
||||
- verbose terminate handling has been added.
|
||||
- some libsupc++ tweaks
|
||||
- warnings for deprecated headers now active.
|
||||
- dejagnu testsuite preliminary documentation.
|
||||
- dejagnu testsuite default.
|
||||
- dejagnu testsuite cross compiler, multilib safe.
|
||||
- long long iostreams on by default, rework of ISO C99 support.
|
||||
- iterator re-write and testsuites.
|
||||
- container testsuites.
|
||||
- allocator revamp and testsuites.
|
||||
- more concept-checking work.
|
||||
- basic_string optimization and MT fixes.
|
||||
- new limits implementation.
|
||||
- update -fno-exceptions code, verify it works.
|
||||
- full named locale support fpr all facets, choice of gnu,
|
||||
ieee_1003.1-200x (POSIX 2), or generic models. Full support depends
|
||||
on target OS and underlying "C" library support.
|
||||
_________________________________________________________________
|
||||
|
||||
4.2 Bugs in gcc/g++ (not libstdc++-v3)
|
||||
|
@ -410,8 +408,9 @@ New:
|
|||
some problems that users may encounter when building or using
|
||||
libstdc++. If you are experiencing one of these problems, you can find
|
||||
more information on the libstdc++ and the GCC mailing lists.
|
||||
* As of 2.91, these bugs have all been fixed. We look forward to new
|
||||
ones, well, not exactly...
|
||||
* As of 3.0.95, those bugs have all been fixed. We look forward to
|
||||
new ones, well, not exactly... Existing bugs are listed in the
|
||||
BUGS file, and the GCC GNATS database.
|
||||
_________________________________________________________________
|
||||
|
||||
4.3 Bugs in the C++ language/lib specification
|
||||
|
|
|
@ -39,11 +39,13 @@
|
|||
<h2><a name="prereqs">Tools you will need beforehand</a></h2>
|
||||
<p>You will need a recent version of g++ to compile the snapshot of
|
||||
libstdc++, such as one of the GCC 3.x snapshots (insert standard
|
||||
caveat about using snapshots rather than formal releases). You
|
||||
will need the full source
|
||||
distribution to whatever compiler release you are using. The
|
||||
GCC snapshots can be had from one of the sites on their
|
||||
<a href="http://gcc.gnu.org/mirrors.html">mirror list</a>.
|
||||
caveat about using snapshots rather than formal releases). You will
|
||||
need the full source distribution to whatever compiler release you are
|
||||
using. The GCC snapshots can be had from one of the sites on their
|
||||
<a href="http://gcc.gnu.org/mirrors.html">mirror list</a>. If you are
|
||||
using a 2.x compiler, see
|
||||
<a href="http://gcc.gnu.org/libstdc++/status.html">the status page</a>
|
||||
first.
|
||||
</p>
|
||||
|
||||
<p>In addition, if you plan to modify the makefiles or regenerate the
|
||||
|
@ -57,9 +59,6 @@
|
|||
worries as long as the versions are correct).
|
||||
</p>
|
||||
|
||||
<p>GNU Make is the only 'make' that will parse the makefiles correctly.
|
||||
</p>
|
||||
|
||||
<p>To test your build, you will need either DejaGNU 1.4 (to run
|
||||
<code>'make check'</code> like
|
||||
<a href="http://gcc.gnu.org/install/test.html">the rest of GCC</a>),
|
||||
|
@ -120,8 +119,9 @@
|
|||
</ol>
|
||||
</p>
|
||||
|
||||
<p>Check out or download the gcc sources: the resulting source directory
|
||||
(<code>gcc</code> or <code>gcc-3.0</code>, for example) is <em>gccsrcdir</em>.
|
||||
<p>Check out or download the GCC sources: the resulting source directory
|
||||
(<code>gcc</code> or <code>gcc-3.0.3</code>, for example) is
|
||||
<em>gccsrcdir</em>.
|
||||
Once in <em>gccsrcdir</em>, you'll need to rename or delete the
|
||||
libstdc++-v3 directory which comes with that snapshot:
|
||||
<pre>
|
||||
|
@ -145,7 +145,7 @@
|
|||
<h2><a name="config">Configuring</a></h2>
|
||||
<p>If you have never done this before, you should read the basic
|
||||
<a href="http://gcc.gnu.org/install/">GCC Installation
|
||||
Instructions</a> first.
|
||||
Instructions</a> first. Read <em>all of them</em>. Twice.
|
||||
</p>
|
||||
<p>When building libstdc++-v3 you'll have to configure
|
||||
the entire <em>gccsrcdir</em> directory. The full list of libstdc++-v3
|
||||
|
|
Loading…
Reference in New Issue