From: Jonathan Wakely Date: Mon, 17 Oct 2016 17:03:50 +0000 (+0100) Subject: Update docs on libstdc++ source-code layout X-Git-Tag: releases/gcc-5.5.0~757 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=0ab73e5201638ab32f83d5d15119a3c2d776fd7e;p=thirdparty%2Fgcc.git Update docs on libstdc++ source-code layout Backport from mainline: 2016-10-10 Jonathan Wakely * doc/xml/manual/appendix_contributing.xml (contrib.organization): Replace with nested elements. Update some more outdated text. * doc/html/*: Regenerate. Backport from mainline: 2016-10-10 Jonathan Wakely * doc/xml/manual/appendix_contributing.xml (contrib.organization): Describe other subdirectories and add markup. Remove outdated reference to check-script target. From-SVN: r241270 --- diff --git a/libstdc++-v3/ChangeLog b/libstdc++-v3/ChangeLog index 89d36097bfc8..18b6538350d1 100644 --- a/libstdc++-v3/ChangeLog +++ b/libstdc++-v3/ChangeLog @@ -1,3 +1,20 @@ +2016-10-17 Jonathan Wakely + + Backport from mainline: + 2016-10-10 Jonathan Wakely + + * doc/xml/manual/appendix_contributing.xml (contrib.organization): + Replace with nested elements. Update + some more outdated text. + * doc/html/*: Regenerate. + + Backport from mainline: + 2016-10-10 Jonathan Wakely + + * doc/xml/manual/appendix_contributing.xml (contrib.organization): + Describe other subdirectories and add markup. Remove outdated + reference to check-script target. + 2016-10-17 Jonathan Wakely Backport from mainline: diff --git a/libstdc++-v3/doc/html/manual/bugs.html b/libstdc++-v3/doc/html/manual/bugs.html index 02963ee2ab88..d1ef5ae28ee7 100644 --- a/libstdc++-v3/doc/html/manual/bugs.html +++ b/libstdc++-v3/doc/html/manual/bugs.html @@ -363,6 +363,9 @@

2059: C++0x ambiguity problem with map::erase

Add additional overloads. +

2062: + 2062. Effect contradictions w/o no-throw guarantee of std::function swaps +

Add noexcept to swap functions.

2063: Contradictory requirements for string move assignment

Respect propagation trait for move assignment. diff --git a/libstdc++-v3/doc/html/manual/source_organization.html b/libstdc++-v3/doc/html/manual/source_organization.html index 1ff2397cf5a7..a5dc9689fdde 100644 --- a/libstdc++-v3/doc/html/manual/source_organization.html +++ b/libstdc++-v3/doc/html/manual/source_organization.html @@ -3,94 +3,95 @@ Contributing  Next

Directory Layout and Source Conventions

- The unpacked source directory of libstdc++ contains the files - needed to create the GNU C++ Library. -


-It has subdirectories:
-
-  doc
-    Files in HTML and text format that document usage, quirks of the
-    implementation, and contributor checklists.
-
-  include
-    All header files for the C++ library are within this directory,
-    modulo specific runtime-related files that are in the libsupc++
-    directory.
-
-    include/std
-      Files meant to be found by #include <name> directives in
-      standard-conforming user programs.
-
-    include/c
-      Headers intended to directly include standard C headers.
-      [NB: this can be enabled via --enable-cheaders=c]
-
-    include/c_global
-      Headers intended to include standard C headers in
-      the global namespace, and put select names into the std::
-      namespace.  [NB: this is the default, and is the same as
-      --enable-cheaders=c_global]
-
-    include/c_std
-      Headers intended to include standard C headers
-      already in namespace std, and put select names into the std::
-      namespace.  [NB: this is the same as --enable-cheaders=c_std]
-
-    include/bits
-      Files included by standard headers and by other files in
-      the bits directory.
-
-    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.
-
-  scripts
-    Scripts that are used during the configure, build, make, or test
-    process.
-
-  src
-    Files that are used in constructing the library, but are not
-    installed.
-
-  testsuites/[backward, demangle, ext, performance, thread, 17_* to 30_*]
-    Test programs are here, and may be used to begin to exercise the
-    library.  Support for "make check" and "make check-install" is
-    complete, and runs through all the subdirectories here when this
-    command is issued from the build directory.  Please note that
-    "make check" requires DejaGNU 1.4 or later to be installed.  Please
-    note that "make check-script" calls the script mkcheck, which
-    requires bash, and which may need the paths to bash adjusted to
-    work properly, as /bin/bash is assumed.
-
-Other subdirectories contain variant versions of certain files
-that are meant to be copied or linked by the configure script.
-Currently these are:
-
-  config/abi
-  config/cpu
-  config/io
-  config/locale
-  config/os
-
-In addition, a subdirectory holds the convenience library libsupc++.
-
-  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/
-directory; or rename bits to (e.g.) cppbits/.
-
-In files throughout the system, lines marked with an "XXX" indicate
-a bug or incompletely-implemented feature.  Lines marked "XXX MT"
-indicate a place that may require attention for multi-thread safety.
-  

Prev Up Next
Appendix A.  + The libstdc++-v3 directory in the + GCC sources contains the files needed to create the GNU C++ Library. +

+It has subdirectories: +

doc
+ Files in HTML and text format that document usage, quirks of the + implementation, and contributor checklists. +
include
+ All header files for the C++ library are within this directory, + modulo specific runtime-related files that are in the libsupc++ + directory. + +
include/std
+ Files meant to be found by #include <name> directives + in standard-conforming user programs. +
include/c
+ Headers intended to directly include standard C headers. + [NB: this can be enabled via --enable-cheaders=c] +
include/c_global
+ Headers intended to include standard C headers in + the global namespace, and put select names into the std:: + namespace. [NB: this is the default, and is the same as + --enable-cheaders=c_global] +
include/c_std
+ Headers intended to include standard C headers + already in namespace std, and put select names into the std:: + namespace. [NB: this is the same as + --enable-cheaders=c_std] +
include/bits
+ Files included by standard headers and by other files in + the bits directory. +
include/backward
+ Headers provided for backward compatibility, such as + <backward/hash_map>. + 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, in theory (there are some + exceptions). +
scripts
+ Scripts that are used during the configure, build, make, or test + process. +
src
+ Files that are used in constructing the library, but are not + installed. + +
src/c++98
+ Source files compiled using -std=gnu++98. +
src/c++11
+ Source files compiled using -std=gnu++11. +
src/filesystem
+ Source files for the Filesystem TS. +
src/shared
+ Source code included by other files under both + src/c++98 and + src/c++11
testsuites/[backward, demangle, ext, performance, thread, 17_* to 30_*]
+ Test programs are here, and may be used to begin to exercise the + library. Support for "make check" and "make check-install" is + complete, and runs through all the subdirectories here when this + command is issued from the build directory. Please note that + "make check" requires DejaGNU 1.4 or later to be installed. +

+Other subdirectories contain variant versions of certain files +that are meant to be copied or linked by the configure script. +Currently these are: +

config/abi
+config/allocator
+config/cpu
+config/io
+config/locale
+config/os
+

+

+In addition, a subdirectory holds the convenience library libsupc++. +

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 need to be careful not to collide with names in its +bits/ directory. +Another solution would be to rename bits +to (e.g.) cppbits. +

+In files throughout the system, lines marked with an "XXX" indicate +a bug or incompletely-implemented feature. Lines marked "XXX MT" +indicate a place that may require attention for multi-thread safety. +

Prev Up Next
Appendix A.  Contributing  Home Coding Style
\ No newline at end of file diff --git a/libstdc++-v3/doc/xml/manual/appendix_contributing.xml b/libstdc++-v3/doc/xml/manual/appendix_contributing.xml index 2c3b9fb3f1c8..aca3d99e4c5a 100644 --- a/libstdc++-v3/doc/xml/manual/appendix_contributing.xml +++ b/libstdc++-v3/doc/xml/manual/appendix_contributing.xml @@ -198,96 +198,197 @@ - The unpacked source directory of libstdc++ contains the files - needed to create the GNU C++ Library. + The libstdc++-v3 directory in the + GCC sources contains the files needed to create the GNU C++ Library. - + It has subdirectories: + - doc + + + doc + Files in HTML and text format that document usage, quirks of the implementation, and contributor checklists. + + - include + + include + All header files for the C++ library are within this directory, modulo specific runtime-related files that are in the libsupc++ directory. - include/std - Files meant to be found by #include <name> directives in - standard-conforming user programs. + + + include/std + + Files meant to be found by #include <name> directives + in standard-conforming user programs. + + - include/c + + include/c + Headers intended to directly include standard C headers. - [NB: this can be enabled via --enable-cheaders=c] + [NB: this can be enabled via ] + + - include/c_global + + include/c_global + Headers intended to include standard C headers in - the global namespace, and put select names into the std:: + the global namespace, and put select names into the std:: namespace. [NB: this is the default, and is the same as - --enable-cheaders=c_global] + ] + + - include/c_std + + include/c_std + Headers intended to include standard C headers - already in namespace std, and put select names into the std:: - namespace. [NB: this is the same as --enable-cheaders=c_std] + already in namespace std, and put select names into the std:: + namespace. [NB: this is the same as + ] + + - include/bits + + include/bits + Files included by standard headers and by other files in the bits directory. + + - include/backward - Headers provided for backward compatibility, such as <iostream.h>. + + include/backward + + Headers provided for backward compatibility, such as + <backward/hash_map>. They are not used in this library. + + - include/ext + + include/ext + Headers that define extensions to the standard library. No - standard header refers to any of them. - - scripts + standard header refers to any of them, in theory (there are some + exceptions). + + + + + + + + scripts + Scripts that are used during the configure, build, make, or test process. + + - src + + src + Files that are used in constructing the library, but are not installed. - testsuites/[backward, demangle, ext, performance, thread, 17_* to 30_*] + + + src/c++98 + + Source files compiled using . + + + + + src/c++11 + + Source files compiled using . + + + + + src/filesystem + + Source files for the Filesystem TS. + + + + + src/shared + + Source code included by other files under both + src/c++98 and + src/c++11 + + + + + + + + testsuites/[backward, demangle, ext, performance, thread, 17_* to 30_*] + Test programs are here, and may be used to begin to exercise the library. Support for "make check" and "make check-install" is complete, and runs through all the subdirectories here when this command is issued from the build directory. Please note that - "make check" requires DejaGNU 1.4 or later to be installed. Please - note that "make check-script" calls the script mkcheck, which - requires bash, and which may need the paths to bash adjusted to - work properly, as /bin/bash is assumed. + "make check" requires DejaGNU 1.4 or later to be installed. + + + + Other subdirectories contain variant versions of certain files that are meant to be copied or linked by the configure script. Currently these are: +config/abi +config/allocator +config/cpu +config/io +config/locale +config/os + + - config/abi - config/cpu - config/io - config/locale - config/os - + In addition, a subdirectory holds the convenience library libsupc++. + - libsupc++ + + + 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/ -directory; or rename bits to (e.g.) cppbits/. + +Note that glibc also has a bits/ +subdirectory. We need to be careful not to collide with names in its +bits/ directory. +Another solution would be to rename bits +to (e.g.) cppbits. + + In files throughout the system, lines marked with an "XXX" indicate a bug or incompletely-implemented feature. Lines marked "XXX MT" indicate a place that may require attention for multi-thread safety. - +