diff mbox series

Document PSTL linker flags

Message ID xkqeo94wfyrq.fsf@trodgers.remote.f27
State New
Headers show
Series Document PSTL linker flags | expand

Commit Message

Thomas Rodgers April 23, 2019, 4:54 p.m. UTC
* doc/xml/manual/using.xml: Add PSTL linker flags to table 3.1.

Comments

Jonathan Wakely April 23, 2019, 7:12 p.m. UTC | #1
On 23/04/19 09:54 -0700, Thomas Rodgers wrote:
>
>	 * doc/xml/manual/using.xml: Add PSTL linker flags to table 3.1.

OK - thanks.
Thomas Rodgers April 23, 2019, 9:05 p.m. UTC | #2
Jonathan Wakely writes:

> On 23/04/19 09:54 -0700, Thomas Rodgers wrote:
>>
>>	 * doc/xml/manual/using.xml: Add PSTL linker flags to table 3.1.
>
> OK - thanks.

Committed to trunk
Jonathan Wakely April 24, 2019, 10:17 p.m. UTC | #3
On 23/04/19 14:05 -0700, Thomas Rodgers wrote:
>
>Jonathan Wakely writes:
>
>> On 23/04/19 09:54 -0700, Thomas Rodgers wrote:
>>>
>>>	 * doc/xml/manual/using.xml: Add PSTL linker flags to table 3.1.
>>
>> OK - thanks.
>
>Committed to trunk

I've also committed this update for the C++17 status docs.
commit 7b79761df0445c3adc8de1d19e05585a1f11e29c
Author: Jonathan Wakely <jwakely@redhat.com>
Date:   Wed Apr 24 23:16:16 2019 +0100

    Update C++17 library status tables
    
            * doc/xml/manual/status_cxx2017.xml: Document P0024R2 status.
            * doc/html/*: Regenerate.

diff --git a/libstdc++-v3/doc/xml/manual/status_cxx2017.xml b/libstdc++-v3/doc/xml/manual/status_cxx2017.xml
index bb82e34bba7..73403ef6ba0 100644
--- a/libstdc++-v3/doc/xml/manual/status_cxx2017.xml
+++ b/libstdc++-v3/doc/xml/manual/status_cxx2017.xml
@@ -633,17 +633,18 @@ Feature-testing recommendations for C++</link>.
     </row>
 
     <row>
-      <?dbhtml bgcolor="#C8B0B0" ?>
+      <?dbhtml bgcolor="#B0B0B0" ?>
       <entry> The Parallelism TS Should be Standardized	 </entry>
       <entry>
 	<link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2016/p0024r2.html">
 	P0024R2
 	</link>
       </entry>
-      <entry align="center"> No </entry>
+      <entry align="center"> 9.1 </entry>
       <entry><code> __has_include(&lt;execution&gt;) </code>,
 	     <code> __cpp_lib_execution >= 201603 </code>,
 	     <code> __cpp_lib_parallel_algorithm >= 201603 </code>
+             (requires linking with <code>-ltbb</code>, see Note 3)
       </entry>
     </row>
 
@@ -689,7 +690,7 @@ Feature-testing recommendations for C++</link>.
       </entry>
       <entry align="center"> 7.1 </entry>
       <entry><code> __cpp_lib_math_special_functions >= 201603 </code>
-	     (see Note 3)
+	     (see Note 4)
       </entry>
     </row>
 
@@ -841,7 +842,13 @@ Note 2: This feature is supported in older releases but the
 </para>
 
 <para>
-Note 3: The mathematical special functions are enabled in C++17 mode from
+Note 3: The Parallel Algorithms have an external dependency on Intel TBB 2018
+or later. If the <filename class="headerfile">&lt;execution&gt;</filename>
+header is included then <code>-ltbb</code> must be used to link to TBB.
+</para>
+
+<para>
+Note 4: The mathematical special functions are enabled in C++17 mode from
 GCC 7.1 onwards. For GCC 6.x or for C++11/C++14 define
 <code>__STDCPP_WANT_MATH_SPEC_FUNCS__</code> to a non-zero value
 and test for <code>__STDCPP_MATH_SPEC_FUNCS__ >= 201003L</code>.
diff mbox series

Patch

From eabe72642bf51b813f454c54ae3cc4e873cf34be Mon Sep 17 00:00:00 2001
From: Thomas Rodgers <trodgers@redhat.com>
Date: Tue, 23 Apr 2019 09:50:13 -0700
Subject: [PATCH] Document PSTL linker flags

	 * doc/xml/manual/using.xml: Add PSTL linker flags to table
           3.1.
---
 libstdc++-v3/doc/xml/manual/using.xml | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/libstdc++-v3/doc/xml/manual/using.xml b/libstdc++-v3/doc/xml/manual/using.xml
index 9e8fe0715a3..8e099d9c3d8 100644
--- a/libstdc++-v3/doc/xml/manual/using.xml
+++ b/libstdc++-v3/doc/xml/manual/using.xml
@@ -107,6 +107,15 @@ 
       <entry><literal>-fopenmp</literal></entry>
       <entry>For <link linkend="manual.ext.parallel_mode">parallel</link> mode.</entry>
     </row>
+    
+    <row>
+      <entry><literal>-ltbb</literal></entry>
+      <entry>Linking to tbb (Thread Building Blocks) is required for use of the
+        Parallel Standard Algorithms and execution policies in
+        <filename class="headerfile">&lt;execution&gt;</filename>.
+      </entry>
+    </row>
+    
   </tbody>
 
 </tgroup>
-- 
2.20.1