From: Jonathan Wakely <jwakely@redhat.com>
Date: Tue, 22 Oct 2024 20:18:51 +0000 (+0100)
Subject: libstdc++: Add GLIBCXX_TESTSUITE_STDS example to docs
X-Git-Tag: basepoints/gcc-16~4977
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=5a661ecdfb22dd6fd1524ee8619be4bc046a1b2a;p=thirdparty%2Fgcc.git

libstdc++: Add GLIBCXX_TESTSUITE_STDS example to docs

libstdc++-v3/ChangeLog:

	* doc/xml/manual/test.xml: Add GLIBCXX_TESTSUITE_STDS example.
	* 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 3657997fad46..1c7af1193daf 100644
--- a/libstdc++-v3/doc/html/manual/test.html
+++ b/libstdc++-v3/doc/html/manual/test.html
@@ -352,12 +352,13 @@ cat 27_io/objects/char/3_xin.in | a.out</pre></dd><dt><span class="term"><code c
       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.
       Adding <code class="code">set v3_std_list { 11 17 23 }</code> to
-      <code class="filename">~/.dejagnurc</code> or a file named by the
+      <code class="filename">~/.dejagnurc</code> or to a file named by the
       <code class="envar">DEJAGNU</code> environment variable will cause every test to
       be run three times, using a different <code class="option">-std</code> each time.
       Alternatively, a list of standard versions to test with can be specified
       as a comma-separated list in the <code class="envar">GLIBCXX_TESTSUITE_STDS</code>
-      environment variable.
+      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.
     </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 40926946fe7a..6b7f1b04a2ac 100644
--- a/libstdc++-v3/doc/xml/manual/test.xml
+++ b/libstdc++-v3/doc/xml/manual/test.xml
@@ -600,12 +600,13 @@ cat 27_io/objects/char/3_xin.in | a.out</programlisting>
       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.
       Adding <code>set v3_std_list { 11 17 23 }</code> to
-      <filename>~/.dejagnurc</filename> or a file named by the
+      <filename>~/.dejagnurc</filename> or to a file named by the
       <envar>DEJAGNU</envar> environment variable will cause every test to
       be run three times, using a different <option>-std</option> each time.
       Alternatively, a list of standard versions to test with can be specified
       as a comma-separated list in the <envar>GLIBCXX_TESTSUITE_STDS</envar>
-      environment variable.
+      environment variable, e.g. <envar>GLIBCXX_TESTSUITE_STDS=11,17,23</envar>
+      is equivalent to the <code>v3_std_list</code> value above.
     </para>
 
     <para>