KJ16609/gcc
1
0
Fork 0
mirror of https://gcc.gnu.org/git/gcc.git synced 2026-02-22 03:46:53 -05:00
Code Issues Packages Projects Releases Wiki Activity

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

Browse Source 
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.
This commit is contained in:
Jonathan Wakely
2025-05-27 17:52:37 +01:00
committed by Jonathan Wakely
parent dc887145c0
commit ebbcd94e47
2 changed files with 6 additions and 22 deletions
Download Patch File Download Diff File Expand all files Collapse all files

13
libstdc++-v3/doc/html/manual/test.html
View File

@@ -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

15
libstdc++-v3/doc/xml/manual/test.xml
View File

@@ -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>