 
 
All of these documents (in fact, this entire homepage set)
   are bundled with the library source, under the 
docs   subdirectory, for releases and snapshots.  The sole exception is the
   automatically-generated source documentation, available separately.
Introduction 
   
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.
   
      
         
17_intro/COPYINGLicense          - GPL v2 license terms
         
abi.htmlABI Policy and Guidelines          
17_intro/BUGSBUGS          
17_intro/PROBLEMSPROBLEMS          - target-specific known issues
         
         
README - directory structure         
17_intro/RELEASE-NOTESRELEASE-NOTES          - latest version info, recent changes and news
         
17_intro/TODOTODO          - tasks yet undone
         
faq/index.htmlFAQ (HTML) , 
             
faq/index.txtFAQ (text)       
Configuring, Building, Testing, Installing 
   
configopts.htmlConfigure options    
install.htmlGetting started: configure, build, install    
   
test.htmlTesting details    
debug.htmlDebugging schemes and strategies    
Source-Level Documentation 
The library sources have been specially formatted so that with the
   proper invocation of another tool (Doxygen), a set of HTML pages
   are generated from the sources files themselves.  The resultant
   documentation is referred to as Source-Level Documentation, and is
   useful for examining the signatures of public member functions for
   the library classes, finding out what is in a particular include
   file, looking at inheritance diagrams, etc.
The source-level documentation for the most recent releases can
   be viewed online:
 
libstdc  -html-USERS-3.4/index.htmlfor the 3.4 release  
latest-doxygen/index.html"the latest collection"    (for the main development tree; see the date on the first page)
 
This generated HTML collection, as above, is also available for download in
   the libstdc++ snapshots directory at
   
<URL:ftp://gcc.gnu.org/pub/gcc/libstdc++/doxygen/>.
   You will almost certainly need to use one of the
   
http://gcc.gnu.org/mirrors.htmlmirror sites  to download
   the tarball.  After unpacking, simply load libstdc++-html-*/index.html
   into a browser.
Documentation for older releases is available for download only, not
   online viewing.
In addition, an initial set of man pages are also available in the
   same place as the HTML collections.  Start with C++Intro(3).
Chapter-Specific Documentation 
Information, extensions, notes and advice on specific implementation 
   capabilites and/or liabilities broken down into chapter names based on the 
   C++ standard.
  
   
Library Introduction (Chapter 17)
   
     
17_intro/howto.html#2The Standard C++ header files      
17_intro/howto.html#3The Standard C++ library and multithreading      
17_intro/howto.html#4<foo> vs <foo.h>      
17_intro/porting-howto.htmlPorting HOWTO      
17_intro/howto.html#5Behavior specific to libstdc++-v3      
17_intro/howto.html#6Preprocessor macros controlling the library    
   
   
Library Support (Chapter 18)
   
     
18_support/howto.html#1Types      
18_support/howto.html#2Implementation properties      
18_support/howto.html#3Start and Termination      
18_support/howto.html#4Verbose terminate      
18_support/howto.html#5Dynamic memory management      
18_support/howto.html#6RTTI, the ABI, and demangling    
   
   
Diagnostics (Chapter 19)
   
     
19_diagnostics/howto.html#1Adding data to exceptions      
19_diagnostics/howto.html#2Exception class hierarchy diagram      
19_diagnostics/howto.html#3Concept checkers -- new and improved!    
   
   
General Utilities (Chapter 20)
   
     
20_util/howto.html#1auto_ptr is not omnipotent      
20_util/howto.html#2auto_ptr inside container classes      
20_util/howto.html#3Functors      
20_util/howto.html#4Pairs      
20_util/howto.html#5Memory allocators    
   
   
Strings (Chapter 21)
   
     
21_strings/howto.html#1MFC's CString      
21_strings/howto.html#2A case-insensitive string class      
21_strings/howto.html#3Breaking a C++ string into tokens      
21_strings/howto.html#4Simple transformations      
21_strings/howto.html#5Making strings of arbitrary character types      
21_strings/howto.html#6Shrink-to-fit strings    
   
   
Localization (Chapter 22)
   
     
22_locale/howto.html#1class locale      
22_locale/howto.html#2class codecvt      
22_locale/howto.html#3class ctype      
22_locale/howto.html#4class messages      
22_locale/howto.html#5Bjarne Stroustrup on Locales      
22_locale/howto.html#6Nathan Myers on Locales      
22_locale/howto.html#7Correct Transformations    
   
   
Containers (Chapter 23)
   
     
23_containers/howto.html#1Making code unaware of the container/array difference      
23_containers/howto.html#2Variable-sized bitmasks      
23_containers/howto.html#3Containers and multithreading      
23_containers/howto.html#4"Hinting" during insertion      
23_containers/howto.html#5Bitmasks and string arguments      
23_containers/howto.html#6std::list::size() is O(n)!      
23_containers/howto.html#7Space overhead management for vectors    
   
   
Iterators (Chapter 24)
   
     
24_iterators/howto.html#1They ain't pointers!      
24_iterators/howto.html#2It ends where?    
   
   
Algorithms (Chapter 25)
   
     
25_algorithms/howto.html#1Prerequisites      
25_algorithms/howto.html#2Special swaps    
   
   
Numerics (Chapter 26)
   
     
26_numerics/howto.html#1Complex Number Processing      
26_numerics/howto.html#2Array Processing      
26_numerics/howto.html#3Numerical Functions      
26_numerics/howto.html#4C99    
   
   
Input/Output (Chapter 27)
   
     
27_io/howto.html#1Copying a file      
27_io/howto.html#2The buffering is screwing up my program!      
27_io/howto.html#3Binary I/O      
27_io/howto.html#5What is this <sstream>/stringstreams thing?      
27_io/howto.html#6Deriving a stream buffer      
27_io/howto.html#7More on binary I/O      
27_io/howto.html#8Pathetic performance?  Ditch C.      
27_io/howto.html#9Threads and I/O      
27_io/howto.html#10Which header?      
27_io/howto.html#11Using FILE*s and file descriptors with IOStreams    
   
   
Extensions to the Standard Library
   
     
ext/pb_assoc/index.htmlPolicy Based Associative Containers      
ext/howto.html#1Ropes and trees and hashes, oh my!      
ext/howto.html#2Added members and types      
ext/mt_allocator.html__mt_alloc      
ext/howto.html#4Compile-time checks      
ext/howto.html#5LWG Issues      
ext/../18_support/howto.html#6Demangling    
   
  
Contributor-Specific Information 
   
17_intro/contribute.htmlContributor checklist    
http://gcc.gnu.org/cvswrite.htmlGetting CVS write access
       (look for "Write after approval")
   
17_intro/BADNAMESBADNAMES        - names to avoid because of potential collisions
   
17_intro/C  STYLEC++STYLE        - coding style by example
   
 In the libstdc++-v3/docs/doxygen directory, see guide.html, a
       doxygen markup style guide
   
17_intro/CHECKLISTCHECKLIST        - a list of required features and their status.
   
17_intro/DESIGNDESIGN        - overview of the implementation plan
   
17_intro/HEADER_POLICYHEADER_POLICY        - header naming and sub-include structure
Return http://gcc.gnu.org/libstdc  /to the libstdc++ homepage .
See 
17_intro/license.htmllicense.html  for copying conditions.
Comments and suggestions are welcome, and may be sent to
mailto:libstdc  @gcc.gnu.orgthe libstdc++ mailing list .
