From: Jonathan Wakely Date: Wed, 14 Sep 2022 12:48:25 +0000 (+0100) Subject: libstdc++: Document LWG 1203 API change in manual X-Git-Tag: basepoints/gcc-14~4534 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=8b1bc3051bd68ce193a8612fa3b1a65c0353b5b0;p=thirdparty%2Fgcc.git libstdc++: Document LWG 1203 API change in manual libstdc++-v3/ChangeLog: * doc/xml/manual/intro.xml: Document LWG 1203. * doc/html/*: Regenerate. --- diff --git a/libstdc++-v3/doc/html/manual/bugs.html b/libstdc++-v3/doc/html/manual/bugs.html index 38594a9b75ab..384fe8d2c4eb 100644 --- a/libstdc++-v3/doc/html/manual/bugs.html +++ b/libstdc++-v3/doc/html/manual/bugs.html @@ -357,6 +357,9 @@ More algorithms that throw away information

The traditional HP / SGI return type and value is blessed by the resolution of the DR. +

1203: + More useful rvalue stream insertion +

Return the stream as its original type, not the base class.

1339: uninitialized_fill_n should return the end of its range

Return the end of the filled range. diff --git a/libstdc++-v3/doc/html/manual/debug_mode_using.html b/libstdc++-v3/doc/html/manual/debug_mode_using.html index 4deb49801616..e26d06c91799 100644 --- a/libstdc++-v3/doc/html/manual/debug_mode_using.html +++ b/libstdc++-v3/doc/html/manual/debug_mode_using.html @@ -9,7 +9,12 @@ units.

By default, error messages are formatted to fit on lines of about 78 characters. The environment variable GLIBCXX_DEBUG_MESSAGE_LENGTH can be used to request a - different length.

Using a Specific Debug Container

When it is not feasible to recompile your entire application, or + different length.

Note that libstdc++ is able to produce backtraces on error. + It requires that you configure libstdc++ build with + --enable-libstdcxx-backtrace=yes. + Use -D_GLIBCXX_DEBUG_BACKTRACE to activate it. + You'll then have to link with libstdc++_libbacktrace static library + (-lstdc++_libbacktrace) to build your application.

Using a Specific Debug Container

When it is not feasible to recompile your entire application, or only specific containers need checking, debugging containers are available as GNU extensions. These debugging containers are functionally equivalent to the standard drop-in containers used in diff --git a/libstdc++-v3/doc/html/manual/using_macros.html b/libstdc++-v3/doc/html/manual/using_macros.html index edbbd03c3360..98230465bed4 100644 --- a/libstdc++-v3/doc/html/manual/using_macros.html +++ b/libstdc++-v3/doc/html/manual/using_macros.html @@ -95,6 +95,11 @@ the debug mode, makes the debug mode extremely picky by making the use of libstdc++ extensions and libstdc++-specific behavior into errors. +

_GLIBCXX_DEBUG_BACKTRACE

+ Undefined by default. Considered only if libstdc++ has been configured with + --enable-libstdcxx-backtrace=yes and if _GLIBCXX_DEBUG + is defined. When defined display backtraces on + debug mode assertions.

_GLIBCXX_PARALLEL

Undefined by default. When defined, compiles user code using the parallel mode. diff --git a/libstdc++-v3/doc/xml/manual/intro.xml b/libstdc++-v3/doc/xml/manual/intro.xml index 290e5d3a74e4..d341c3efe6de 100644 --- a/libstdc++-v3/doc/xml/manual/intro.xml +++ b/libstdc++-v3/doc/xml/manual/intro.xml @@ -852,6 +852,12 @@ requirements of the license of GCC. by the resolution of the DR. + 1203: + More useful rvalue stream insertion + + Return the stream as its original type, not the base class. + + 1339: uninitialized_fill_n should return the end of its range