From: Jonathan Wakely <jwakely@redhat.com>
Date: Tue, 27 May 2025 16:52:37 +0000 (+0100)
Subject: libstdc++: Document that -std cannot be used in --target_board now
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=ebbcd94e47deb1a154c8a9a18252cd2dae566734;p=thirdparty%2Fgcc.git

libstdc++: Document that -std cannot be used in --target_board now

Only using GLIBCXX_TESTSUITE_STDS or v3_std_list works now.

libstdc++-v3/ChangeLog:

	* doc/xml/manual/test.xml: Remove outdated documentation on
	testing with -std options in --target_board.
	* doc/html/manual/test.html: Regenerate.
---

diff --git a/libstdc++-v3/doc/html/manual/test.html b/libstdc++-v3/doc/html/manual/test.html
index 947cd948d83..f2cf8c42437 100644
--- a/libstdc++-v3/doc/html/manual/test.html
+++ b/libstdc++-v3/doc/html/manual/test.html
@@ -338,16 +338,6 @@ cat 27_io/objects/char/3_xin.in | a.out</pre></dd><dt><span class="term"><code c
       <code class="option">-O1 -D_GLIBCXX_ASSERTIONS</code>
       you could use:
 </p><pre class="programlisting">    make check RUNTESTFLAGS=--target_board=unix/-O1/-D_GLIBCXX_ASSERTIONS</pre><p>
-    </p><p>
-      The <code class="option">--target_board</code> option can also be used to run the
-      tests multiple times in different variations. For example, to run the
-      entire testsuite three times using <code class="option">-O3</code> but with
-      different <code class="option">-std</code> options:
-</p><pre class="programlisting">    make check 'RUNTESTFLAGS=--target_board=unix/-O3\"{-std=gnu++98,-std=gnu++11,-std=gnu++17}\"'</pre><p>
-      N.B. that set of variations could also be written as
-      <code class="literal">unix/-O3\"{-std=gnu++98,-std=gnu++11,}\"</code> so that
-      the third variation would use the default for <code class="option">-std</code>
-      (which is <code class="option">-std=gnu++17</code> as of GCC 11).
     </p><p>
       Since GCC 14, the libstdc++ testsuite has built-in support for running
       tests with more than one <code class="option">-std</code>, similar to the G++ tests.
@@ -359,6 +349,9 @@ cat 27_io/objects/char/3_xin.in | a.out</pre></dd><dt><span class="term"><code c
       as a comma-separated list in the <code class="envar">GLIBCXX_TESTSUITE_STDS</code>
       environment variable, e.g. <code class="envar">GLIBCXX_TESTSUITE_STDS=11,17,23</code>
       is equivalent to the <code class="code">v3_std_list</code> value above.
+      Before GCC 14, the <code class="option">--target_board</code> option could be
+      used to run the tests with different <code class="option">-std</code> options,
+      but this no longer works.
     </p><p>
       To run the libstdc++ test suite under the
       <a class="link" href="debug_mode.html" title="Chapter 17. Debug Mode">debug mode</a>, use
diff --git a/libstdc++-v3/doc/xml/manual/test.xml b/libstdc++-v3/doc/xml/manual/test.xml
index c4f501102dc..8e2729eedfd 100644
--- a/libstdc++-v3/doc/xml/manual/test.xml
+++ b/libstdc++-v3/doc/xml/manual/test.xml
@@ -584,18 +584,6 @@ cat 27_io/objects/char/3_xin.in | a.out</programlisting>
 <programlisting>    make check RUNTESTFLAGS=--target_board=unix/-O1/-D_GLIBCXX_ASSERTIONS</programlisting>
     </para>
 
-    <para>
-      The <option>--target_board</option> option can also be used to run the
-      tests multiple times in different variations. For example, to run the
-      entire testsuite three times using <option>-O3</option> but with
-      different <option>-std</option> options:
-<programlisting>    make check 'RUNTESTFLAGS=--target_board=unix/-O3\"{-std=gnu++98,-std=gnu++11,-std=gnu++17}\"'</programlisting>
-      N.B. that set of variations could also be written as
-      <literal>unix/-O3\"{-std=gnu++98,-std=gnu++11,}\"</literal> so that
-      the third variation would use the default for <option>-std</option>
-      (which is <option>-std=gnu++17</option> as of GCC 11).
-    </para>
-
     <para>
       Since GCC 14, the libstdc++ testsuite has built-in support for running
       tests with more than one <option>-std</option>, similar to the G++ tests.
@@ -607,6 +595,9 @@ cat 27_io/objects/char/3_xin.in | a.out</programlisting>
       as a comma-separated list in the <envar>GLIBCXX_TESTSUITE_STDS</envar>
       environment variable, e.g. <envar>GLIBCXX_TESTSUITE_STDS=11,17,23</envar>
       is equivalent to the <code>v3_std_list</code> value above.
+      Before GCC 14, the <option>--target_board</option> option could be
+      used to run the tests with different <option>-std</option> options,
+      but this no longer works.
     </para>
 
     <para>