commit: 0694647c00f905a313f5315c5c6f8476b411b8d7
Author: Sam James <sam <AT> gentoo <DOT> org>
AuthorDate: Thu Sep 4 20:28:06 2025 +0000
Commit: Sam James <sam <AT> gentoo <DOT> org>
CommitDate: Thu Sep 4 20:30:37 2025 +0000
URL: https://gitweb.gentoo.org/repo/gentoo.git/commit/?id=0694647c
sys-devel/gcc: improve USE=debug description
Signed-off-by: Sam James <sam <AT> gentoo.org>
sys-devel/gcc/metadata.xml | 10 +++++++++-
1 file changed, 9 insertions(+), 1 deletion(-)
diff --git a/sys-devel/gcc/metadata.xml b/sys-devel/gcc/metadata.xml
index c2a4c832cf06..a0646ed2637c 100644
--- a/sys-devel/gcc/metadata.xml
+++ b/sys-devel/gcc/metadata.xml
@@ -37,7 +37,15 @@
<flag name="cobol">Enable support for the COBOL programming
language</flag>
<flag name="d">Enable support for the D programming
language</flag>
<flag name="debug">
- Enables GCC's 'checking' facility via
--enable-checking=yes,extra,rtl.
+ Enables GCC's 'checking' (assertions) facility.
+
+ For released GCCs:
+ * USE=debug sets --enable-checking=yes,extra,rtl
+ * USE=-debug sets --enable-checking=release
+
+ For unreleased GCCs:
+ * USE=debug sets --enable-checking=yes,extra,rtl
+ * USE=-debug sets --enable-checking=yes,extra
This adds checks to various compiler passes for
integrity and input
validation. This can help catch possible
miscompilations early as
