Commit 1b75c936 by Jonathan Wakely Committed by Jonathan Wakely

Editorial fixes to libstdc++ debug mode docs

	* doc/xml/manual/debug_mode.xml: Minor editorial fixes.
	* doc/html/*: Regenerate.

From-SVN: r240161
parent 700e2faa
2016-09-15 Jonathan Wakely <jwakely@redhat.com> 2016-09-15 Jonathan Wakely <jwakely@redhat.com>
* testsuite/23_containers/vector/debug/insert6_neg.cc: Remove * doc/xml/manual/debug_mode.xml: Minor editorial fixes.
-Wno-deprecated. * doc/html/*: Regenerate.
* testsuite/util/debug/checks.h (generate_unique<bool>): Specialize.
2016-09-15 Jonathan Wakely <jwakely@redhat.com>
* testsuite/23_containers/vector/debug/insert6_neg.cc: Remove * testsuite/23_containers/vector/debug/insert6_neg.cc: Remove
-Wno-deprecated. -Wno-deprecated.
......
...@@ -352,8 +352,7 @@ test02() ...@@ -352,8 +352,7 @@ test02()
declarations disallow specialization. This method fails 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 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> namespaces. </em></span>
See <a class="link" href="http://gcc.gnu.org/ml/libstdc++/2003-08/msg00004.html" target="_top"> this post See <a class="link" href="http://gcc.gnu.org/ml/libstdc++/2003-08/msg00004.html" target="_top">this post</a>.
</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 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 allow the debug mode to effectively alias the
namespace <code class="code">std</code> to an internal namespace, such namespace <code class="code">std</code> to an internal namespace, such
...@@ -365,8 +364,8 @@ test02() ...@@ -365,8 +364,8 @@ test02()
instance, the program would have two <code class="code">std::cout</code> instance, the program would have two <code class="code">std::cout</code>
objects! This solution would fails the <span class="emphasis"><em>minimize objects! This solution would fails the <span class="emphasis"><em>minimize
recompilation</em></span> requirement, because we would only be able to 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 support option (1) or (2).</p></li><li class="listitem"><p><span class="emphasis"><em>Extension: use link name</em></span>: This option
complicated re-naming between debug-mode and release-mode involves complicated re-naming between debug-mode and release-mode
components at compile time, and then a g++ extension called <span class="emphasis"><em> 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 link name </em></span> to recover the original names at link time. There
are two drawbacks to this approach. One, it's very verbose, are two drawbacks to this approach. One, it's very verbose,
...@@ -375,8 +374,8 @@ test02() ...@@ -375,8 +374,8 @@ test02()
functions taking no arguments in mixed-mode settings resulting in functions taking no arguments in mixed-mode settings resulting in
equivalent link names, <code class="code"> vector::push_back() </code> being equivalent link names, <code class="code"> vector::push_back() </code> being
one example. one example.
See <a class="link" href="http://gcc.gnu.org/ml/libstdc++/2003-08/msg00177.html" target="_top">link 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 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 which have probably been considered and others that may still be
lurking. This list may be expanded over time to include other lurking. This list may be expanded over time to include other
options that we could have implemented, but in all cases the full options that we could have implemented, but in all cases the full
......
...@@ -800,8 +800,7 @@ test02() ...@@ -800,8 +800,7 @@ test02()
<listitem><para><emphasis> Use implementation-specific properties of anonymous <listitem><para><emphasis> Use implementation-specific properties of anonymous
namespaces. </emphasis> 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 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>.
</link>
This method fails the <emphasis>correctness</emphasis> criteria.</para></listitem> This method fails the <emphasis>correctness</emphasis> criteria.</para></listitem>
<listitem><para><emphasis>Extension: allow reopening on namespaces</emphasis>: This would <listitem><para><emphasis>Extension: allow reopening on namespaces</emphasis>: This would
...@@ -817,8 +816,8 @@ test02() ...@@ -817,8 +816,8 @@ test02()
recompilation</emphasis> requirement, because we would only be able to recompilation</emphasis> requirement, because we would only be able to
support option (1) or (2).</para></listitem> support option (1) or (2).</para></listitem>
<listitem><para><emphasis>Extension: use link name</emphasis>: This option involves <listitem><para><emphasis>Extension: use link name</emphasis>: This option
complicated re-naming between debug-mode and release-mode involves complicated re-naming between debug-mode and release-mode
components at compile time, and then a g++ extension called <emphasis> components at compile time, and then a g++ extension called <emphasis>
link name </emphasis> to recover the original names at link time. There link name </emphasis> to recover the original names at link time. There
are two drawbacks to this approach. One, it's very verbose, are two drawbacks to this approach. One, it's very verbose,
...@@ -827,8 +826,8 @@ test02() ...@@ -827,8 +826,8 @@ test02()
functions taking no arguments in mixed-mode settings resulting in functions taking no arguments in mixed-mode settings resulting in
equivalent link names, <code> vector::push_back() </code> being equivalent link names, <code> vector::push_back() </code> being
one example. 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 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> name</link>. </para></listitem>
</itemizedlist> </itemizedlist>
<para>Other options may exist for implementing the debug mode, many of <para>Other options may exist for implementing the debug mode, many of
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment