From mboxrd@z Thu Jan 1 00:00:00 1970
Return-Path:
Received: by sourceware.org (Postfix, from userid 2181)
id DA5E4385B52D; Fri, 27 Oct 2023 21:08:33 +0000 (GMT)
DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org DA5E4385B52D
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=sourceware.org;
s=default; t=1698440913;
bh=a46h+o6L8avMSbdrEmBc/AWowgewzwK0foJgFGMn/s0=;
h=To:Subject:Date:From:From;
b=UXGCbFNWoGiT9ww/XNVh8Igv0C8XKmpxdcMRm538eUemqSg2p+q+DM+Wfm2k8y5ek
FX9TNAqeZon42/qhr0k+41hjmKhyXbqyqcYZ5stH95M9iswihv1BwuOq5Mb8CtYq7F
e9A/fAROuiIbX09iYq3IuiM5QJckXDdPhpzHXgoM=
To: gcc-cvs-wwwdocs@gcc.gnu.org
Subject: gcc-wwwdocs branch master updated. 76857f1aae9af9d04ea401004f29c988a2593140
X-Git-Refname: refs/heads/master
X-Git-Reftype: branch
X-Git-Oldrev: ccd0ad7343f217de53a755433329e384faa99339
X-Git-Newrev: 76857f1aae9af9d04ea401004f29c988a2593140
Message-Id: <20231027210833.DA5E4385B52D@sourceware.org>
Date: Fri, 27 Oct 2023 21:08:33 +0000 (GMT)
From: Jonathan Wakely
List-Id:
This is an automated email from the git hooks/post-receive script. It was
generated because a ref change was pushed to the repository containing
the project "gcc-wwwdocs".
The branch, master has been updated
via 76857f1aae9af9d04ea401004f29c988a2593140 (commit)
from ccd0ad7343f217de53a755433329e384faa99339 (commit)
Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.
- Log -----------------------------------------------------------------
commit 76857f1aae9af9d04ea401004f29c988a2593140
Author: Sam James
Date: Fri Oct 27 22:07:15 2023 +0100
bugs: Mention -D_GLIBCXX_ASSERTIONS and -D_GLIBCXX_DEBUG
These options both enable more checking within the C++ standard library
and can expose errors in submitted code.
-D_GLIBCXX_DEBUG is mentioned separately because while we want people to try it,
it's not always feasible because it requires the whole program and any used
libraries to also be built with it (as it breaks ABI).
Signed-off-by: Sam James
diff --git a/htdocs/bugs/index.html b/htdocs/bugs/index.html
index da3d4c0d..40355911 100644
--- a/htdocs/bugs/index.html
+++ b/htdocs/bugs/index.html
@@ -56,6 +56,14 @@ makes a difference, or if compiling with -fsanitize=undefined
produces any run-time errors, then your code is probably not correct.
+We also ask that for C++ code, users test their programs with
+-D_GLIBCXX_ASSERTIONS
. If you're able to rebuild the entire
+program (including any libraries it uses, because it changes ABI), please do try
+libstdc++'s debug mode
+(-D_GLIBCXX_DEBUG
) which enables more thorough checking in parts of
+the C++ standard library. If either of these fail, this is a strong indicator
+of an error in your code.
+
Summarized bug reporting instructions
After this summary, you'll find detailed instructions that explain
-----------------------------------------------------------------------
Summary of changes:
htdocs/bugs/index.html | 8 ++++++++
1 file changed, 8 insertions(+)
hooks/post-receive
--
gcc-wwwdocs