diff options
author | Jonathan Wakely <jwakely@redhat.com> | 2016-09-15 11:30:58 +0100 |
---|---|---|
committer | Jonathan Wakely <redi@gcc.gnu.org> | 2016-09-15 11:30:58 +0100 |
commit | 1b75c936018a0931c3b599e624bd15c4fb7c4fe6 (patch) | |
tree | 227e77240a38ebe6b2cbf222146e73675597bf88 | |
parent | 700e2faaf5272b411073fc5ff1acb2ba16cb49e5 (diff) | |
download | gcc-1b75c936018a0931c3b599e624bd15c4fb7c4fe6.zip gcc-1b75c936018a0931c3b599e624bd15c4fb7c4fe6.tar.gz gcc-1b75c936018a0931c3b599e624bd15c4fb7c4fe6.tar.bz2 |
Editorial fixes to libstdc++ debug mode docs
* doc/xml/manual/debug_mode.xml: Minor editorial fixes.
* doc/html/*: Regenerate.
From-SVN: r240161
-rw-r--r-- | libstdc++-v3/ChangeLog | 7 | ||||
-rw-r--r-- | libstdc++-v3/doc/html/manual/debug_mode_design.html | 11 | ||||
-rw-r--r-- | libstdc++-v3/doc/xml/manual/debug_mode.xml | 11 |
3 files changed, 12 insertions, 17 deletions
diff --git a/libstdc++-v3/ChangeLog b/libstdc++-v3/ChangeLog index 02a4691..f81e87f 100644 --- a/libstdc++-v3/ChangeLog +++ b/libstdc++-v3/ChangeLog @@ -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. diff --git a/libstdc++-v3/doc/html/manual/debug_mode_design.html b/libstdc++-v3/doc/html/manual/debug_mode_design.html index 747f192..3373471 100644 --- a/libstdc++-v3/doc/html/manual/debug_mode_design.html +++ b/libstdc++-v3/doc/html/manual/debug_mode_design.html @@ -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 diff --git a/libstdc++-v3/doc/xml/manual/debug_mode.xml b/libstdc++-v3/doc/xml/manual/debug_mode.xml index 8b5380d..ff2f1cc 100644 --- a/libstdc++-v3/doc/xml/manual/debug_mode.xml +++ b/libstdc++-v3/doc/xml/manual/debug_mode.xml @@ -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 |