public inbox for libstdc++-cvs@sourceware.org help / color / mirror / Atom feed
From: Jonathan Wakely <redi@gcc.gnu.org> To: gcc-cvs@gcc.gnu.org, libstdc++-cvs@gcc.gnu.org Subject: [gcc r13-7785] libstdc++: Update outdated default -std in testing docs Date: Fri, 8 Sep 2023 17:13:55 +0000 (GMT) [thread overview] Message-ID: <20230908171355.BCCFE3876897@sourceware.org> (raw) https://gcc.gnu.org/g:d8e351d8d656720f4037e0a86a4a6c73629e5307 commit r13-7785-gd8e351d8d656720f4037e0a86a4a6c73629e5307 Author: Jonathan Wakely <jwakely@redhat.com> Date: Fri Sep 8 16:28:06 2023 +0100 libstdc++: Update outdated default -std in testing docs libstdc++-v3/ChangeLog: * doc/xml/manual/test.xml: Update reference to -std=gnu++14 as the default. * doc/html/manual/test.html: Regenerate. Diff: --- libstdc++-v3/doc/html/manual/test.html | 10 +++++----- libstdc++-v3/doc/xml/manual/test.xml | 10 +++++----- 2 files changed, 10 insertions(+), 10 deletions(-) diff --git a/libstdc++-v3/doc/html/manual/test.html b/libstdc++-v3/doc/html/manual/test.html index fadadf249bb3..a308ecf5996f 100644 --- a/libstdc++-v3/doc/html/manual/test.html +++ b/libstdc++-v3/doc/html/manual/test.html @@ -468,7 +468,7 @@ cat 27_io/objects/char/3_xin.in | a.out</pre></dd><dt><span class="term"><code c be run for a specific standard (and not later standards) using an effective target like <code class="literal">c++11_only</code>. However, this means the test will be skipped by default (because the default mode is - <code class="literal">gnu++14</code>), and so will only run when + <code class="literal">gnu++17</code>), and so will only run when <code class="option">-std=gnu++11</code> or <code class="option">-std=c++11</code> is used explicitly. For tests that require a specific standard it is better to use a <code class="literal">dg-options</code> directive: @@ -482,13 +482,13 @@ cat 27_io/objects/char/3_xin.in | a.out</pre></dd><dt><span class="term"><code c Similarly, tests which depend on a newer standard than the default must use <code class="literal">dg-options</code> instead of (or in addition to) an effective target, so that they are not skipped by default. - For example, tests for C++17 features should use -</p><pre class="programlisting"> // { dg-options "-std=gnu++17" }</pre><p> + For example, tests for C++20 features should use +</p><pre class="programlisting"> // { dg-options "-std=gnu++20" }</pre><p> before any <code class="literal">dg-do</code> such as: -</p><pre class="programlisting"> // { dg-do run "c++17" }</pre><p> +</p><pre class="programlisting"> // { dg-do run { target c++20 } }</pre><p> The <code class="literal">dg-options</code> directive must come first, so that the <code class="literal">-std</code> flag has already been added to the options - before checking the <code class="literal">c++17</code> target. + before checking the <code class="literal">c++20</code> effective target. </p><div class="section"><div class="titlepage"><div><div><h4 class="title"><a id="tests.dg.examples"></a>Examples of Test Directives</h4></div></div></div><p> Example 1: Testing compilation only: </p><pre class="programlisting"> diff --git a/libstdc++-v3/doc/xml/manual/test.xml b/libstdc++-v3/doc/xml/manual/test.xml index 964c53d26322..9853a2848148 100644 --- a/libstdc++-v3/doc/xml/manual/test.xml +++ b/libstdc++-v3/doc/xml/manual/test.xml @@ -767,7 +767,7 @@ cat 27_io/objects/char/3_xin.in | a.out</programlisting> be run for a specific standard (and not later standards) using an effective target like <literal>c++11_only</literal>. However, this means the test will be skipped by default (because the default mode is - <literal>gnu++14</literal>), and so will only run when + <literal>gnu++17</literal>), and so will only run when <option>-std=gnu++11</option> or <option>-std=c++11</option> is used explicitly. For tests that require a specific standard it is better to use a <literal>dg-options</literal> directive: @@ -783,13 +783,13 @@ cat 27_io/objects/char/3_xin.in | a.out</programlisting> Similarly, tests which depend on a newer standard than the default must use <literal>dg-options</literal> instead of (or in addition to) an effective target, so that they are not skipped by default. - For example, tests for C++17 features should use -<programlisting> // { dg-options "-std=gnu++17" }</programlisting> + For example, tests for C++20 features should use +<programlisting> // { dg-options "-std=gnu++20" }</programlisting> before any <literal>dg-do</literal> such as: -<programlisting> // { dg-do run "c++17" }</programlisting> +<programlisting> // { dg-do run { target c++20 } }</programlisting> The <literal>dg-options</literal> directive must come first, so that the <literal>-std</literal> flag has already been added to the options - before checking the <literal>c++17</literal> target. + before checking the <literal>c++20</literal> effective target. </para> <section xml:id="tests.dg.examples"><info><title>Examples of Test Directives</title></info>
reply other threads:[~2023-09-08 17:13 UTC|newest] Thread overview: [no followups] expand[flat|nested] mbox.gz Atom feed
Reply instructions: You may reply publicly to this message via plain-text email using any one of the following methods: * Save the following mbox file, import it into your mail client, and reply-to-all from there: mbox Avoid top-posting and favor interleaved quoting: https://en.wikipedia.org/wiki/Posting_style#Interleaved_style * Reply using the --to, --cc, and --in-reply-to switches of git-send-email(1): git send-email \ --in-reply-to=20230908171355.BCCFE3876897@sourceware.org \ --to=redi@gcc.gnu.org \ --cc=gcc-cvs@gcc.gnu.org \ --cc=libstdc++-cvs@gcc.gnu.org \ /path/to/YOUR_REPLY https://kernel.org/pub/software/scm/git/docs/git-send-email.html * If your mail client supports setting the In-Reply-To header via mailto: links, try the mailto: linkBe sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions for how to clone and mirror all data and code used for this inbox; as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).