file: libstdc++-v3/READMENew users may wish to point their web browsers to the filedocumentation.html in the 'docs/html' subdirectory. It contains briefbuilding instructions and notes on how to configure the library ininteresting ways.Instructions for configuring and building appear indocs/html/install.html.This directory contains the files needed to create an ISO Standard C++Library.It has subdirectories:docsFiles in HTML and text format that document usage, quirks of theimplementation, and contributor checklists.includeAll header files for the C++ library are within this directory,modulo specific runtime-related files that are in the libsupc++directory.include/stdFiles meant to be found by #include <name> directives instandard-conforming user programs.include/cHeaders intended to directly include standard C headers.[NB: this can be enabled via --enable-cheaders=c]include/c_stdHeaders intended to include standard C headers, and put selectnames into the std:: namespace.[NB: this is the default, and is the same as --enable-cheaders=c_std]include/bitsFiles included by standard headers and by other files inthe bits directory.include/backwardHeaders provided for backward compatibility, such as <iostream.h>.They are not used in this library.include/extHeaders that define extensions to the standard library. Nostandard header refers to any of them.scriptsScripts that are used during the configure, build, make, or testprocess.srcFiles that are used in constructing the library, but are notinstalled.testsuites/[backward, demangle, ext, performance, thread, 17_* to 27_*]Test programs are here, and may be used to begin to exercise thelibrary. Support for "make check" and "make check-install" iscomplete, and runs through all the subdirectories here when thiscommand is issued from the build directory. Please note that"make check" requires DejaGNU 1.4 or later to be installed. Pleasenote that "make check-script" calls the script mkcheck, whichrequires bash, and which may need the paths to bash adjusted towork properly, as /bin/bash is assumed.Other subdirectories contain variant versions of certain filesthat are meant to be copied or linked by the configure script.Currently these are:config/abiconfig/cpuconfig/ioconfig/localeconfig/osIn addition, two subdirectories are convenience libraries:libmathSupport routines needed for C++ math. Only needed if theunderlying "C" implementation is non-existent, in particularrequired or optimal long double, long long, and C99 functionality.libsupc++Contains the runtime library for C++, including exceptionhandling and memory allocation and deallocation, RTTI, terminatehandlers, etc.Note that glibc also has a bits/ subdirectory. We will eitherneed to be careful not to collide with names in its bits/directory; or rename bits to (e.g.) cppbits/.In files throughout the system, lines marked with an "XXX" indicatea bug or incompletely-implemented feature. Lines marked "XXX MT"indicate a place that may require attention for multi-thread safety.