From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: by sourceware.org (Postfix, from userid 2181) id 54E0C38582AF; Wed, 14 Sep 2022 18:22:19 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 54E0C38582AF DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gcc.gnu.org; s=default; t=1663179739; bh=gj1kqpVTCsC/9M0+FxaJllIqK9vUHDMfITREyi2H1mQ=; h=From:To:Subject:Date:From; b=q+SfmyBg3r0Q96ykjugKqWvSi8FHnPXh/QpD6T1WJhy+7Cyzvw9AqrvKDc0KZ4F/O i9qh5cG7ShaPSa/zOcfpwW9m+oGeWuCPeJBbqXw1hN2Ah97PscpbowdvhDFmTvc+Qk AhyA94jXgl3jC3Ab1a5HDUAVA3aL+b4w5evtjVqY= MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Content-Type: text/plain; charset="utf-8" From: Jonathan Wakely To: gcc-cvs@gcc.gnu.org, libstdc++-cvs@gcc.gnu.org Subject: [gcc r13-2673] libstdc++: Document LWG 1203 API change in manual X-Act-Checkin: gcc X-Git-Author: Jonathan Wakely X-Git-Refname: refs/heads/master X-Git-Oldrev: 93257ed603d72b58bb2616da5b63c4c6737f424b X-Git-Newrev: 8b1bc3051bd68ce193a8612fa3b1a65c0353b5b0 Message-Id: <20220914182219.54E0C38582AF@sourceware.org> Date: Wed, 14 Sep 2022 18:22:19 +0000 (GMT) List-Id: https://gcc.gnu.org/g:8b1bc3051bd68ce193a8612fa3b1a65c0353b5b0 commit r13-2673-g8b1bc3051bd68ce193a8612fa3b1a65c0353b5b0 Author: Jonathan Wakely Date: Wed Sep 14 13:48:25 2022 +0100 libstdc++: Document LWG 1203 API change in manual libstdc++-v3/ChangeLog: * doc/xml/manual/intro.xml: Document LWG 1203. * doc/html/*: Regenerate. Diff: --- libstdc++-v3/doc/html/manual/bugs.html | 3 +++ libstdc++-v3/doc/html/manual/debug_mode_using.html | 7 ++++++- libstdc++-v3/doc/html/manual/using_macros.html | 5 +++++ libstdc++-v3/doc/xml/manual/intro.xml | 6 ++++++ 4 files changed, 20 insertions(+), 1 deletion(-) diff --git a/libstdc++-v3/doc/html/manual/bugs.html b/libstdc++-v3/doc/html/manual/bugs.html index 38594a9b75a..384fe8d2c4e 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 4deb4980161..e26d06c9179 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 edbbd03c336..98230465bed 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 290e5d3a74e..d341c3efe6d 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