aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorJonathan Wakely <jwakely@redhat.com>2016-09-15 11:30:58 +0100
committerJonathan Wakely <redi@gcc.gnu.org>2016-09-15 11:30:58 +0100
commit1b75c936018a0931c3b599e624bd15c4fb7c4fe6 (patch)
tree227e77240a38ebe6b2cbf222146e73675597bf88
parent700e2faaf5272b411073fc5ff1acb2ba16cb49e5 (diff)
downloadgcc-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/ChangeLog7
-rw-r--r--libstdc++-v3/doc/html/manual/debug_mode_design.html11
-rw-r--r--libstdc++-v3/doc/xml/manual/debug_mode.xml11
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