+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
</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>
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
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>
<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
<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
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
<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>
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).
<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
<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>
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>
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
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.
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)
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
<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
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>),
</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>
<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
projects / platform / upstream / gcc.git / commitdiff