summaryrefslogtreecommitdiff
path: root/libstdc++-v3/README
diff options
context:
space:
mode:
authorBenjamin Kosnik <bkoz@redhat.com>2001-12-18 22:01:20 +0000
committerBenjamin Kosnik <bkoz@gcc.gnu.org>2001-12-18 22:01:20 +0000
commit9560d353d38cd1efb65c919eb44953503bcfafdc (patch)
tree77b645b3c50864dd4a852ff5d96633bea0fef5ba /libstdc++-v3/README
parentae6c1efd658f081036d6e10c5f70e84db3dbbe46 (diff)
downloadgcc-9560d353d38cd1efb65c919eb44953503bcfafdc.tar.gz
TODO: Update.
2001-12-18 Benjamin Kosnik <bkoz@redhat.com> * docs/html/17_intro/TODO: Update. * docs/html/17_intro/RELEASE-NOTES: Edits, update. * README: Edit for clarity, update to reflect current directory structure. From-SVN: r48165
Diffstat (limited to 'libstdc++-v3/README')
-rw-r--r--libstdc++-v3/README53
1 files changed, 31 insertions, 22 deletions
diff --git a/libstdc++-v3/README b/libstdc++-v3/README
index 3ace755fa0e..f95a8c93382 100644
--- a/libstdc++-v3/README
+++ b/libstdc++-v3/README
@@ -4,12 +4,11 @@ New users may wish to point their web browsers to the file documentation.html
in the 'docs/html' subdirectory. It contains brief building instructions and
notes on how to configure the library in interesting ways.
+Instructions for configuring and building appear in
+docs/html/install.html.
-Instructions for configuring and building this snapshot appear
-in docs/html/install.html.
-
-This directory contains the files needed to create [a still broken
-subset of] an ISO Standard C++ Library.
+This directory contains the files needed to create an ISO Standard C++
+Library.
It has subdirectories:
@@ -17,23 +16,10 @@ It has subdirectories:
Files in HTML and text format that document usage, quirks of the
implementation, and contributor checklists.
- include/bits
- Files included by standard headers and by other files in
- the bits directory. Includes a set of files bits/std_xxxx.h
- that implement the standard headers <xxxx>.
-
include/std
Files meant to be found by #include <name> directives in
standard-conforming user programs.
- include/ext
- Headers that define extensions to the standard library. No
- standard header refers to any of them.
-
- include/backward
- Headers provided for backward compatibility, such as <iostream.h>.
- They are not used in this library.
-
include/c
Headers intended to directly include standard C headers.
[NB: this can be enabled via --enable-cheaders=c]
@@ -50,6 +36,19 @@ It has subdirectories:
defined there into the _C_legacy namespace.
[NB: this can be enabled via --enable-cheaders=c_shadow]
+ include/bits
+ Files included by standard headers and by other files in
+ the bits directory. Includes a set of files bits/std_xxxx.h
+ that implement the standard headers <xxxx>.
+
+ include/backward
+ Headers provided for backward compatibility, such as <iostream.h>.
+ They are not used in this library.
+
+ include/ext
+ Headers that define extensions to the standard library. No
+ standard header refers to any of them.
+
src
Files that are used in constructing the library, but are not
installed.
@@ -73,10 +72,20 @@ Currently these are:
config/io
config/locale
-Files needed only to construct the library, but not installed,
-are in src/. Files to be copied as part of an installation are
-all found in the subdirectories mentioned above. (A configure
-script may link files from another directory into one of these.)
+In addition, three subdirectories are convenience libraries:
+
+ libio
+ Contains the subset of the GNU libio library needed for
+ C++. Currently not used.
+
+ libmath
+ Support routines needed for C++ math. Only needed if the
+ underlying "C" implementation is weak or looses.
+
+ libsupc++
+ Contains the runtime library for C++, including exception
+ handling and memory allocation and deallocation, RTTI, terminate
+ handlers, etc.
Note that glibc also has a bits/ subdirectory. We will either
need to be careful not to collide with names in its bits/