Editorial fixes to libstdc++ debug mode docs
authorJonathan Wakely <jwakely@redhat.com>
Thu, 15 Sep 2016 10:30:58 +0000 (11:30 +0100)
committerJonathan Wakely <redi@gcc.gnu.org>
Thu, 15 Sep 2016 10:30:58 +0000 (11:30 +0100)
* doc/xml/manual/debug_mode.xml: Minor editorial fixes.
* doc/html/*: Regenerate.

From-SVN: r240161

libstdc++-v3/ChangeLog
libstdc++-v3/doc/html/manual/debug_mode_design.html
libstdc++-v3/doc/xml/manual/debug_mode.xml

index 02a4691ea9f75facf8d91b2aadc1caa1b6556722..f81e87f9694489d898f1a066b1d30e8080a624c9 100644 (file)
@@ -1,10 +1,7 @@
 2016-09-15  Jonathan Wakely  <jwakely@redhat.com>
 
-       * testsuite/23_containers/vector/debug/insert6_neg.cc: Remove
-       -Wno-deprecated.
-       * testsuite/util/debug/checks.h (generate_unique<bool>): Specialize.
-
-2016-09-15  Jonathan Wakely  <jwakely@redhat.com>
+       * doc/xml/manual/debug_mode.xml: Minor editorial fixes.
+       * doc/html/*: Regenerate.
 
        * testsuite/23_containers/vector/debug/insert6_neg.cc: Remove
        -Wno-deprecated.
index 747f192c47fd25c8ca1f731310a3a3c072ace4b6..3373471d48e5fbfa554eeaa79ec55c8d23ea2dff 100644 (file)
@@ -352,8 +352,7 @@ test02()
       declarations disallow specialization. This method fails
       the <span class="emphasis"><em>correctness</em></span> criteria.</p></li><li class="listitem"><p><span class="emphasis"><em> Use implementation-specific properties of anonymous
     namespaces. </em></span>
-    See <a class="link" href="http://gcc.gnu.org/ml/libstdc++/2003-08/msg00004.html" target="_top"> this post
-    </a>
+    See <a class="link" href="http://gcc.gnu.org/ml/libstdc++/2003-08/msg00004.html" target="_top">this post</a>.
     This method fails the <span class="emphasis"><em>correctness</em></span> criteria.</p></li><li class="listitem"><p><span class="emphasis"><em>Extension: allow reopening on namespaces</em></span>: This would
     allow the debug mode to effectively alias the
     namespace <code class="code">std</code> to an internal namespace, such
@@ -365,8 +364,8 @@ test02()
     instance, the program would have two <code class="code">std::cout</code>
     objects! This solution would fails the <span class="emphasis"><em>minimize
     recompilation</em></span> requirement, because we would only be able to
-    support option (1) or (2).</p></li><li class="listitem"><p><span class="emphasis"><em>Extension: use link name</em></span>: This option involves
-    complicated re-naming between debug-mode and release-mode
+    support option (1) or (2).</p></li><li class="listitem"><p><span class="emphasis"><em>Extension: use link name</em></span>: This option
+    involves complicated re-naming between debug-mode and release-mode
     components at compile time, and then a g++ extension called <span class="emphasis"><em>
     link name </em></span> to recover the original names at link time. There
     are two drawbacks to this approach. One, it's very verbose,
@@ -375,8 +374,8 @@ test02()
     functions taking no arguments in mixed-mode settings resulting in
     equivalent link names, <code class="code"> vector::push_back() </code> being
     one example.
-    See <a class="link" href="http://gcc.gnu.org/ml/libstdc++/2003-08/msg00177.html" target="_top">link
-    name</a> </p></li></ul></div><p>Other options may exist for implementing the debug mode, many of
+    See <a class="link" href="http://gcc.gnu.org/ml/libstdc++/2003-08/msg00177.html" target="_top">proof-of-concept using link
+    name</a>. </p></li></ul></div><p>Other options may exist for implementing the debug mode, many of
   which have probably been considered and others that may still be
   lurking. This list may be expanded over time to include other
   options that we could have implemented, but in all cases the full
index 8b5380dfeec994b060207d1f8a73f59c192b24e1..ff2f1cced8992a4998a2d750d53d87ecb0844538 100644 (file)
@@ -800,8 +800,7 @@ test02()
 
   <listitem><para><emphasis> Use implementation-specific properties of anonymous
     namespaces. </emphasis>
-    See <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://gcc.gnu.org/ml/libstdc++/2003-08/msg00004.html"> this post
-    </link>
+    See <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://gcc.gnu.org/ml/libstdc++/2003-08/msg00004.html">this post</link>.
     This method fails the <emphasis>correctness</emphasis> criteria.</para></listitem>
 
   <listitem><para><emphasis>Extension: allow reopening on namespaces</emphasis>: This would
@@ -817,8 +816,8 @@ test02()
     recompilation</emphasis> requirement, because we would only be able to
     support option (1) or (2).</para></listitem>
 
-  <listitem><para><emphasis>Extension: use link name</emphasis>: This option involves
-    complicated re-naming between debug-mode and release-mode
+  <listitem><para><emphasis>Extension: use link name</emphasis>: This option
+    involves complicated re-naming between debug-mode and release-mode
     components at compile time, and then a g++ extension called <emphasis>
     link name </emphasis> to recover the original names at link time. There
     are two drawbacks to this approach. One, it's very verbose,
@@ -827,8 +826,8 @@ test02()
     functions taking no arguments in mixed-mode settings resulting in
     equivalent link names, <code> vector::push_back() </code> being
     one example.
-    See <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://gcc.gnu.org/ml/libstdc++/2003-08/msg00177.html">link
-    name</link> </para></listitem>
+    See <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://gcc.gnu.org/ml/libstdc++/2003-08/msg00177.html">proof-of-concept using link
+    name</link>. </para></listitem>
 </itemizedlist>
 
 <para>Other options may exist for implementing the debug mode, many of