status_cxx2011.xml: Add caveats for native_handle.
authorJonathan Wakely <jwakely@redhat.com>
Fri, 17 Jul 2015 16:08:14 +0000 (17:08 +0100)
committerJonathan Wakely <redi@gcc.gnu.org>
Fri, 17 Jul 2015 16:08:14 +0000 (17:08 +0100)
* doc/xml/manual/status_cxx2011.xml: Add caveats for native_handle.
* doc/html/manual/status.html: Regenerate.

From-SVN: r225939

libstdc++-v3/ChangeLog
libstdc++-v3/doc/html/manual/status.html
libstdc++-v3/doc/xml/manual/status_cxx2011.xml

index 3362427f99746c64f3fe9ae9e9f188f15e39c96d..7f1a85c22134c85df52b9cc91e4bab5471a2f812 100644 (file)
@@ -1,3 +1,8 @@
+2015-07-17  Jonathan Wakely  <jwakely@redhat.com>
+
+       * doc/xml/manual/status_cxx2011.xml: Add caveats for native_handle.
+       * doc/html/manual/status.html: Regenerate.
+
 2015-07-16  François Dumont  <fdumont@gcc.gnu.org>
 
        * include/bits/stl_algobase.h (__miter_base): Move...
index 0885b5db3262fb11087f3c6e83943223febe76d3..e28bfbad8a96f9ad96afea2d3ca8d2c0815acb0b 100644 (file)
@@ -297,7 +297,10 @@ particular release.
       <span class="emphasis"><em>30.2.3 [thread.req.native]/1</em></span>
       <code class="classname">native_handle_type</code> and
       <code class="methodname">native_handle</code> are provided. The handle types
-      are defined in terms of the Gthreads abstraction layer.
+      are defined in terms of the Gthreads abstraction layer, although this
+      is subject to change at any time. Any use of
+      <code class="classname">native_handle</code> is inherently non-portable and
+      not guaranteed to work between major releases of GCC.
       </p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p><code class="classname">thread</code>: The native handle type is
             a typedef for <code class="code">__gthread_t</code> i.e. <code class="code">pthread_t</code>
             when GCC is configured with the <code class="literal">posix</code> thread
index 2b99b9d19706023fe6a110a315650cdc0fcde4aa..cf99956b7eb7c2ea2460d20f5d7cbfee9b31592c 100644 (file)
@@ -2670,7 +2670,10 @@ particular release.
       <emphasis>30.2.3 [thread.req.native]/1</emphasis>
       <classname>native_handle_type</classname> and
       <methodname>native_handle</methodname> are provided. The handle types
-      are defined in terms of the Gthreads abstraction layer.
+      are defined in terms of the Gthreads abstraction layer, although this
+      is subject to change at any time. Any use of
+      <classname>native_handle</classname> is inherently non-portable and
+      not guaranteed to work between major releases of GCC.
       <itemizedlist>
          <listitem><para><classname>thread</classname>: The native handle type is
             a typedef for <code>__gthread_t</code> i.e. <code>pthread_t</code>