diff options
Diffstat (limited to 'libstdc++-v3/docs/html/documentation.html')
| -rw-r--r-- | libstdc++-v3/docs/html/documentation.html | 329 |
1 files changed, 177 insertions, 152 deletions
diff --git a/libstdc++-v3/docs/html/documentation.html b/libstdc++-v3/docs/html/documentation.html index 8987a521d06..a4a79e32b54 100644 --- a/libstdc++-v3/docs/html/documentation.html +++ b/libstdc++-v3/docs/html/documentation.html @@ -1,10 +1,14 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> -<html> +<?xml version="1.0" encoding="ISO-8859-1"?> +<!DOCTYPE html + PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" + "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> + +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> <head> <meta name="KEYWORDS" - content="libstdc++, homepage, home, C++, library, c++, std, g++, ABI, STL"> + content="libstdc++, homepage, home, C++, library, c++, std, g++, ABI, STL" /> <title>GNU C++ Standard Library</title> -<link rel="StyleSheet" href="lib3styles.css"> +<link rel="StyleSheet" href="lib3styles.css" /> </head> <body> @@ -15,40 +19,40 @@ automatically-generated source documentation, available separately. </p> - <hr /> -<br> +<br /> <h2><a name="1">Introduction</a></h2> <p>This is a short list of text files pertaining to this implementation of ISO 14882. A brief description may follow the name of the file. + </p> <ul> <li><a href="17_intro/COPYING">License</a> - - GPL v2 license terms - <li><a href="abi.txt">ABI Policy and Guidelines</a> - <li><a href="17_intro/BUGS">BUGS</a> + - GPL v2 license terms</li> + <li><a href="abi.txt">ABI Policy and Guidelines</a></li> + <li><a href="17_intro/BUGS">BUGS</a></li> <li><a href="17_intro/PROBLEMS">PROBLEMS</a> - - target-specific known issues + - target-specific known issues</li> <!-- Linking to "../README" doesn't work; we are at the top level of the web pages. Punt. --> - <li>README - directory structure + <li>README - directory structure</li> <li><a href="17_intro/RELEASE-NOTES">RELEASE-NOTES</a> - - latest version info, recent changes and news + - latest version info, recent changes and news</li> <li><a href="17_intro/TODO">TODO</a> - - tasks yet undone + - tasks yet undone</li> </ul> - <hr /> -<br> +<br /> <h2><a name="2">Configuring, Building, Installing</a></h2> - <ul> - <li><a href="configopts.html">Configure options</a> - <li><a href="install.html">Getting started: configure, build, install</a> - </ul> +<ul> + <li><a href="configopts.html">Configure options</a></li> + <li><a href="install.html">Getting started: configure, build, install</a> + </li> +</ul> <hr /> -<br> +<br /> <h2><a name="4">Source-Level Documentation</a></h2> <p>The library sources have been specially formatted so that with the proper invocation of another tool (Doxygen), a set of HTML pages @@ -58,13 +62,16 @@ the library classes, finding out what is in a particular include file, looking at inheritance diagrams, etc. </p> -<p>The Source-Level documentation can be viewed online: - <ul> +<p>The Source-Level documentation can be viewed online:</p> +<ul> <li><a href="libstdc++-html-USERS-3.1/index.html">for the 3.1 release</a> + </li> <li><a href="libstdc++-html-USERS-3.2/index.html">for the 3.2 release</a> + </li> <li><a href="latest-doxygen/index.html">"the latest collection"</a> (for the snapshot or later; see the date on the first page) - </ul> + </li> +</ul> <p>This generated HTML collection, as above, is also available for download in the libstdc++ snapshots directory at <code><URL:ftp://gcc.gnu.org/pub/gcc/libstdc++/doxygen/></code>. @@ -81,142 +88,160 @@ <hr /> -<br> +<br /> <h2><a name="3">Chapter-Specific Documentation</a></h2> <p>Information, extensions, notes and advice on specific implementation - capabilites and or liabilities broken down into chapter names based on the + capabilites and/or liabilities broken down into chapter names based on the C++ standard. </p> - <ul> - <li>Intro (Chapter 17) - <ul> - <li><a href="17_intro/howto.html#1">Header files</a> - <li><a href="17_intro/howto.html#3">Using <foo> vs <foo.h></a> - <li><a href="17_intro/howto.html#2">Multithreading</a> - <li><a href="17_intro/howto.html#4">Porting</a> - <li><a href="17_intro/howto.html#5">Implementation-specific behavior</a> - <li><a href="17_intro/howto.html#6">Using preprocessor macros to change behavior of the library</a> - </ul> - - <li>Library Support (Chapter 18) - <ul> - <li><a href="18_support/howto.html#1">Types</a> - <li><a href="18_support/howto.html#2">Implementation properties</a> - <li><a href="18_support/howto.html#3">Start and Termination</a> - <li><a href="18_support/howto.html#4">Dynamic memory management</a> - <li><a href="18_support/howto.html#5">RTTI, the ABI, and demangling</a> - </ul> - - - <li>Diagnostics (Chapter 19) - <ul> - <li><a href="19_diagnostics/howto.html#1">Adding data to exceptions</a> - <li><a href="19_diagnostics/howto.html#2">Exception class hierarchy diagram</a> - <li><a href="19_diagnostics/howto.html#3">Concept checkers -- new and improved!</a> - <li><a href="19_diagnostics/howto.html#4">Verbose terminate</a> - </ul> - - <li>Utilities (Chapter 20) - <ul> - <li><a href="20_util/howto.html#1">auto_ptr is not omnipotent</a> - <li><a href="20_util/howto.html#1">auto_ptr inside container classes</a> - <li><a href="20_util/howto.html#1">Functors</a> - <li><a href="20_util/howto.html#1">Pairs</a> - </ul> - - - <li>Strings (Chapter 21) - <ul> - <li><a href="21_strings/howto.html#1">MFC's CString</a> - <li><a href="21_strings/howto.html#2">A case-insensitive string class</a> - <li><a href="21_strings/howto.html#3">Breaking a C++ string into tokens</a> - <li><a href="21_strings/howto.html#4">Simple transformations</a> - </ul> - - <li>Localization (Chapter 22) - <ul> - <li><a href="22_locale/howto.html#1">Class locale</a> - <li><a href="22_locale/howto.html#2">Class codecvt</a> - <li><a href="22_locale/howto.html#3">Class ctype</a> - <li><a href="22_locale/howto.html#4">Class messages</a> - <li><a href="22_locale/howto.html#5">Bjarne Stroustrup on Locales</a> - <li><a href="22_locale/howto.html#6">Nathan Myers on Locales</a> - <li><a href="22_locale/howto.html#7">Correct Transformations </a> - </ul> - - <li>Containers (Chapter 23) - <ul> - <li><a href="23_containers/howto.html#1">Making code unaware of the container/array difference</a> - <li><a href="23_containers/howto.html#2">Variable-sized bitmasks</a> - <li><a href="23_containers/howto.html#3">Containers and multithreading</a> - <li><a href="23_containers/howto.html#4">"Hinting" during insertion</a> - <li><a href="23_containers/howto.html#5">Bitmasks and string arguments</a> - <li><a href="23_containers/howto.html#6"><code>std::list::size()</code> is O(n)!</a> - <li><a href="23_containers/howto.html#7">Space overhead management for vectors </a> - </ul> - - <li>Iterators (Chapter24) - <ul> - <li><a href="24_iterators/howto.html#1">They aren't pointers!</a> - <li><a href="24_iterators/howto.html#1">It ends where?</a> - </ul> - - <li>Algorithms (Chapter 25) - <ul> - <li><a href="25_algorithms/howto.html#1">Prerequisites</a> - <li><a href="25_algorithms/howto.html#2">Special swaps</a> - </ul> - - <li>Numerics (Chapter 26) - <ul> - <li><a href="26_numerics/howto.html#1">Complex Number Processing</a> - <li><a href="26_numerics/howto.html#2">Array Processing</a> - <li><a href="26_numerics/howto.html#3">Numerical Functions</a> - <li><a href="26_numerics/howto.html#4">C99</a> - </ul> - - <li>I/O (Chapter 27) - <ul> - <li><a href="27_io/howto.html#1">Copying a file</a> - <li><a href="27_io/howto.html#2">The buffering is screwing up my program!</a> - </ul> - <ul> - <li><a href="27_io/howto.html#3">Binary I/O</a> - <li><a href="27_io/howto.html#6">More on binary I/O</a> - <li><a href="27_io/howto.html#5">Deriving a stream buffer</a> - <li><a href="27_io/howto.html#4">What is this <sstream>/stringstreams thing?</a> - <li><a href="27_io/howto.html#7">Pathetic performance? Ditch C.</a> - <li><a href="27_io/howto.html#8">Threads and I/O</a> - </ul> - - <li>Extensions to the Standard Library - <ul> - <li><a href="ext/howto.html#1">Ropes and trees and hashes, oh my!</a> - <li><a href="ext/howto.html#2">Added members and types</a> - <li><a href="ext/howto.html#3">Allocators (versions 3.0, 3.1, 3.2)</a> - <li><a href="ext/howto.html#4">Allocators (version 3.3)</a> - <li><a href="ext/howto.html#5">Compile-time checks</a> - <li><a href="ext/howto.html#6">LWG Issues</a> - </ul> - </ul> +<!-- + The list below is automatically generated. To make changes in the text, + edit the appropriate HOWTO file and run "make" in this directory. In + those files, you may reorder entries as you like, but DO NOT change the + "#number"s in anchors, for they are used elsewhere and in bookmarks. +--> +<!-- beginlist --> + <ul> + <li>Library Introduction (Chapter 17) + <ul> + <li><a href="17_intro/howto.html#2">The Standard C++ header files</a></li> + <li><a href="17_intro/howto.html#3">The Standard C++ library and multithreading</a></li> + <li><a href="17_intro/howto.html#4"><code><foo></code> vs <code><foo.h></code></a></li> + <li><a href="17_intro/porting-howto.html">Porting HOWTO</a></li> + <li><a href="17_intro/howto.html#5">Behavior specific to libstdc++-v3</a></li> + <li><a href="17_intro/howto.html#6">Preprocessor macros controlling the library</a></li> + </ul> + </li> + + <li>Library Support (Chapter 18) + <ul> + <li><a href="18_support/howto.html#1">Types</a></li> + <li><a href="18_support/howto.html#2">Implementation properties</a></li> + <li><a href="18_support/howto.html#3">Start and Termination</a></li> + <li><a href="18_support/howto.html#4">Dynamic memory management</a></li> + <li><a href="18_support/howto.html#5">RTTI, the ABI, and demangling</a></li> + </ul> + </li> + + <li>Diagnostics (Chapter 19) + <ul> + <li><a href="19_diagnostics/howto.html#1">Adding data to exceptions</a></li> + <li><a href="19_diagnostics/howto.html#2">Exception class hierarchy diagram</a></li> + <li><a href="19_diagnostics/howto.html#3">Concept checkers -- <strong>new and improved!</strong></a></li> + <li><a href="19_diagnostics/howto.html#4">Verbose <code>terminate</code></a></li> + </ul> + </li> + + <li>General Utilities (Chapter 20) + <ul> + <li><a href="20_util/howto.html#1"><code>auto_ptr</code> is not omnipotent</a></li> + <li><a href="20_util/howto.html#2"><code>auto_ptr</code> inside container classes</a></li> + <li><a href="20_util/howto.html#3">Functors</a></li> + <li><a href="20_util/howto.html#4">Pairs</a></li> + </ul> + </li> + + <li>Strings (Chapter 21) + <ul> + <li><a href="21_strings/howto.html#1">MFC's CString</a></li> + <li><a href="21_strings/howto.html#2">A case-insensitive string class</a></li> + <li><a href="21_strings/howto.html#3">Breaking a C++ string into tokens</a></li> + <li><a href="21_strings/howto.html#4">Simple transformations</a></li> + <li><a href="21_strings/howto.html#5">Making strings of arbitrary character types</a></li> + </ul> + </li> + + <li>Localization (Chapter 22) + <ul> + <li><a href="22_locale/howto.html#1">class locale</a></li> + <li><a href="22_locale/howto.html#2">class codecvt</a></li> + <li><a href="22_locale/howto.html#3">class ctype</a></li> + <li><a href="22_locale/howto.html#4">class messages</a></li> + <li><a href="22_locale/howto.html#5">Bjarne Stroustrup on Locales</a></li> + <li><a href="22_locale/howto.html#6">Nathan Myers on Locales</a></li> + <li><a href="22_locale/howto.html#7">Correct Transformations</a></li> + </ul> + </li> + + <li>Containers (Chapter 23) + <ul> + <li><a href="23_containers/howto.html#1">Making code unaware of the container/array difference</a></li> + <li><a href="23_containers/howto.html#2">Variable-sized bitmasks</a></li> + <li><a href="23_containers/howto.html#3">Containers and multithreading</a></li> + <li><a href="23_containers/howto.html#4">"Hinting" during insertion</a></li> + <li><a href="23_containers/howto.html#5">Bitmasks and string arguments</a></li> + <li><a href="23_containers/howto.html#6"><code>std::list::size()</code> is O(n)!</a></li> + <li><a href="23_containers/howto.html#7">Space overhead management for vectors</a></li> + </ul> + </li> + + <li>Iterators (Chapter 24) + <ul> + <li><a href="24_iterators/howto.html#1">They ain't pointers!</a></li> + <li><a href="24_iterators/howto.html#2">It ends <em>where?</em></a></li> + </ul> + </li> + + <li>Algorithms (Chapter 25) + <ul> + <li><a href="25_algorithms/howto.html#1">Prerequisites</a></li> + <li><a href="25_algorithms/howto.html#2">Special <code>swap</code>s</a></li> + </ul> + </li> + + <li>Numerics (Chapter 26) + <ul> + <li><a href="26_numerics/howto.html#1">Complex Number Processing</a></li> + <li><a href="26_numerics/howto.html#2">Array Processing</a></li> + <li><a href="26_numerics/howto.html#3">Numerical Functions</a></li> + <li><a href="26_numerics/howto.html#4">C99</a></li> + </ul> + </li> + + <li>Input/Output (Chapter 27) + <ul> + <li><a href="27_io/howto.html#1">Copying a file</a></li> + <li><a href="27_io/howto.html#2">The buffering is screwing up my program!</a></li> + <li><a href="27_io/howto.html#3">Binary I/O</a></li> + <li><a href="27_io/howto.html#5">What is this <sstream>/stringstreams thing?</a></li> + <li><a href="27_io/howto.html#6">Deriving a stream buffer</a></li> + <li><a href="27_io/howto.html#7">More on binary I/O</a></li> + <li><a href="27_io/howto.html#8">Pathetic performance? Ditch C.</a></li> + <li><a href="27_io/howto.html#9">Threads and I/O</a></li> + </ul> + </li> + + <li>Extensions to the Standard Library + <ul> + <li><a href="ext/howto.html#1">Ropes and trees and hashes, oh my!</a></li> + <li><a href="ext/howto.html#2">Added members and types</a></li> + <li><a href="ext/howto.html#3">Allocators (versions 3.0, 3.1, 3.2)</a></li> + <li><a href="ext/howto.html#6">Allocators (version 3.3)</a></li> + <li><a href="ext/howto.html#4">Compile-time checks</a></li> + <li><a href="ext/howto.html#5">LWG Issues</a></li> + </ul> + </li> + + </ul> +<!-- endlist --> <hr /> -<br> +<br /> <h2><a name="5">Contributor-Specific Information</a></h2> - <ul> - <li><a href="17_intro/contribute.html">Contributor checklist</a> - <li><a href="17_intro/libstdc++-assign.txt">Copyright assignment form for libstdc++-v3</a> - <li><a href="17_intro/BADNAMES">BADNAMES</a> - - names to avoid because of potential collisions - <li><a href="17_intro/C++STYLE">C++STYLE</a> - - coding style by example - <li><a href="17_intro/CHECKLIST">CHECKLIST</a> - - a list of required features and their status. - <li><a href="17_intro/DESIGN">DESIGN</a> - - overview of the implementation plan - <li><a href="17_intro/HEADER_POLICY">HEADER_POLICY</a> - - header naming and sub-include structure - </ul> +<ul> + <li><a href="17_intro/contribute.html">Contributor checklist</a></li> + <li><a href="17_intro/libstdc++-assign.txt">Copyright assignment form for libstdc++-v3</a></li> + <li><a href="17_intro/BADNAMES">BADNAMES</a> + - names to avoid because of potential collisions</li> + <li><a href="17_intro/C++STYLE">C++STYLE</a> + - coding style by example</li> + <li><a href="17_intro/CHECKLIST">CHECKLIST</a> + - a list of required features and their status.</li> + <li><a href="17_intro/DESIGN">DESIGN</a> + - overview of the implementation plan</li> + <li><a href="17_intro/HEADER_POLICY">HEADER_POLICY</a> + - header naming and sub-include structure</li> +</ul> <!-- ####################################################### --> |