From 0c36c983ecb522688b3e4dbad6196839188509d9 Mon Sep 17 00:00:00 2001
From: "H.J. Lu" <hjl.tools@gmail.com>
Date: Tue, 24 Dec 2024 05:20:43 +0800
Subject: [PATCH] NEWS: Mention testing glibc build with a different set of
 compilers

Also document C and C++ compilers used to test glibc should come from
the same set of compilers.

Signed-off-by: H.J. Lu <hjl.tools@gmail.com>
Reviewed-by: Sam James <sam@gentoo.org>
---
 INSTALL             |  6 +++---
 NEWS                | 11 +++++++++++
 manual/install.texi |  7 +++----
 3 files changed, 17 insertions(+), 7 deletions(-)

diff --git a/INSTALL b/INSTALL
index 85c8e4cef1..717b34a374 100644
--- a/INSTALL
+++ b/INSTALL
@@ -49,9 +49,9 @@ if 'CFLAGS' is specified it must enable optimization.  For example:
 
      $ ../glibc-VERSION/configure CC="gcc -m32" CFLAGS="-O3"
 
-   To test the GNU C Library with a different C compiler or a different
-C++ compiler, 'TEST_CC=COMPILER' and 'TEST_CXX=COMPILER' arguments can
-be passed to 'configure'.  For example:
+   To test the GNU C Library with a different set of C and C++
+compilers, 'TEST_CC=COMPILER' and 'TEST_CXX=COMPILER' arguments can be
+passed to 'configure'.  For example:
 
      $ ../glibc-VERSION/configure TEST_CC="gcc-6.4.1" TEST_CXX="g++-6.4.1"
 
diff --git a/NEWS b/NEWS
index a185f2e7ee..4ceecd6249 100644
--- a/NEWS
+++ b/NEWS
@@ -9,6 +9,17 @@ Version 2.41
 
 Major new features:
 
+* Support testing glibc build with a different set of C and C++ compilers
+  from the C and C++ compilers used to build glibc with
+
+  $ ../configure TEST_CC="gcc-6.4.1" TEST_CXX="g++-6.4.1"
+
+  And support testing glibc build with Clang
+
+  $ ../configure TEST_CC="clang" TEST_CXX="clang++"
+
+  Some run-time failures with Clang are expected.
+
 * In /etc/resolv.conf and the RES_OPTIONS, option flags can now be
   prefixed with “-” to clear previously set flags.  For example, if
   /etc/resolv.conf contains “options no-aaaa”, a process running with
diff --git a/manual/install.texi b/manual/install.texi
index 61745b88d8..05a774b33b 100644
--- a/manual/install.texi
+++ b/manual/install.texi
@@ -75,10 +75,9 @@ and @theglibc{} cannot be compiled without optimization, so if
 $ ../glibc-@var{version}/configure CC="gcc -m32" CFLAGS="-O3"
 @end smallexample
 
-To test @theglibc{} with a different C compiler or a different C++
-compiler, @samp{TEST_CC=@var{compiler}} and
-@samp{TEST_CXX=@var{compiler}} arguments can be passed to
-@code{configure}.  For example:
+To test @theglibc{} with a different set of C and C++ compilers,
+@samp{TEST_CC=@var{compiler}} and @samp{TEST_CXX=@var{compiler}}
+arguments can be passed to @code{configure}.  For example:
 
 @smallexample
 $ ../glibc-@var{version}/configure TEST_CC="gcc-6.4.1" TEST_CXX="g++-6.4.1"