[gentoo-commits] repo/gentoo:master commit in: llvm-core/clang-common/

["Sam James" <sam@gentoo.org>]

commit:     34330ce1861e63a03e38f014ecee3bdb82914d80
Author:     Sam James <sam <AT> gentoo <DOT> org>
AuthorDate: Wed Jan 29 21:24:08 2025 +0000
Commit:     Sam James <sam <AT> gentoo <DOT> org>
CommitDate: Wed Jan 29 21:24:21 2025 +0000
URL:        https://gitweb.gentoo.org/repo/gentoo.git/commit/?id=34330ce1

llvm-core/clang-common: make USE=default-libcxx description scary

Bug: https://bugs.gentoo.org/944478
Signed-off-by: Sam James <sam <AT> gentoo.org>

 llvm-core/clang-common/metadata.xml | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/llvm-core/clang-common/metadata.xml b/llvm-core/clang-common/metadata.xml
index da45c87b0e27..a4b5da44a19b 100644
--- a/llvm-core/clang-common/metadata.xml
+++ b/llvm-core/clang-common/metadata.xml
@@ -20,7 +20,13 @@
 			but provides no benefit either.
 		</flag>
 		<flag name="default-compiler-rt">Use compiler-rt + libunwind instead of libgcc as the default rtlib for clang</flag>
-		<flag name="default-libcxx">Use libc++ instead of libstdc++ as the default stdlib for clang</flag>
+		<flag name="default-libcxx">
+			Use libc++ instead of libstdc++ as the default stdlib for clang.
+
+			Beware: this breaks ABI, producing binaries incompatible with those
+			built with GCC or Clang using libstdc++. Do not set unless you know
+			what you're doing.
+		</flag>
 		<flag name="default-lld">Use lld as the default linker for clang</flag>
 		<flag name="stricter">Default to stricter behavior known from newer clang versions, turning more warnings into errors</flag>
 	</use>