https://gcc.gnu.org/g:ebbcd94e47deb1a154c8a9a18252cd2dae566734
commit r16-951-gebbcd94e47deb1a154c8a9a18252cd2dae566734
Author: Jonathan Wakely <jwak...@redhat.com>
Date: Tue May 27 17:52:37 2025 +0100
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:
---
libstdc++-v3/doc/html/manual/test.html | 13 +++----------
libstdc++-v3/doc/xml/manual/test.xml | 15 +++------------
2 files changed, 6 insertions(+), 22 deletions(-)
diff --git a/libstdc++-v3/doc/html/manual/test.html
b/libstdc++-v3/doc/html/manual/test.html
index 947cd948d830..f2cf8c424370 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 c4f501102dc7..8e2729eedfdf 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>
