OpenE2K
/
gcc
2
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

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:
Phil Edwards 2001-12-19 21:36:33 +00:00
parent 366f6a5273
commit 572cd73ac9
8 changed files with 109 additions and 89 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

10
libstdc++-v3/ChangeLog
View File

@ -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

BIN
libstdc++-v3/docs/html/17_intro/RELEASE-NOTES
View File

Binary file not shown.

24
libstdc++-v3/docs/html/configopts.html
View File

@ -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

22
libstdc++-v3/docs/html/documentation.html
View File

@ -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>&lt;URL:ftp://gcc.gnu.org/pub/gcc/libstdc++/&gt;</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>&lt;URL:ftp://gcc.gnu.org/pub/gcc/libstdc++/doxygen/&gt;</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>

16
libstdc++-v3/docs/html/ext/howto.html
View File

@ -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&lt;int&gt; gets cut in half
and frees a bunch of its storage, that memory can be reused by the
private std::list&lt;WonkyWidget&gt; 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

53
libstdc++-v3/docs/html/faq/index.html
View File

@ -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 &quot;make
doxygen&quot; 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 &lt;limits&gt;
- 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>

51
libstdc++-v3/docs/html/faq/index.txt
View File

@ -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

22
libstdc++-v3/docs/html/install.html
View File

@ -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