This is the mail archive of the
libstdc++@gcc.gnu.org
mailing list for the libstdc++ project.
Re: xml/manual/debug_mode.xml reference to Namespace Association
- From: Gerald Pfeifer <gerald at pfeifer dot com>
- To: Jonathan Wakely <jwakely dot gcc at gmail dot com>, François Dumont <fdumont at gcc dot gnu dot org>
- Cc: libstdc++ <libstdc++ at gcc dot gnu dot org>
- Date: Thu, 2 Mar 2017 08:42:47 -0800 (PST)
- Subject: Re: xml/manual/debug_mode.xml reference to Namespace Association
- Authentication-results: sourceware.org; auth=none
- References: <alpine.LSU.2.20.1703010541170.2487@anthias.pfeifer.com> <CAH6eHdRTYEZZBhyEY9+UxEfF8N8mML_xnUKU3kQBEs4w5QPx=g@mail.gmail.com>
On Thu, 2 Mar 2017, Jonathan Wakely wrote:
>> Any hints? Suggestions how to go about this? (Perhaps simply omit
>> the first half of that sentence?)
> Jason deprecated the feature and removed the docs in r244936.
Ah, thank you!
> I agree with François's suggestion, but I wouldn't even bother
> mentioning anything about previous modes, just say "To achieve this
> goal we use inline namespaces and a complex organization ..."
Thanks to both of you. I believe the patch below implements all
of your suggested changes; does this look okay?
Gerald
2017-03-02 Gerald Pfeifer <gerald@pfeifer.com>
François Dumont <frs.dumont@gmail.com>
Jonathan Wakely <jwakely@redhat.com>
Index: doc/xml/manual/debug_mode.xml
===================================================================
--- doc/xml/manual/debug_mode.xml (revision 245843)
+++ doc/xml/manual/debug_mode.xml (working copy)
@@ -584,15 +584,11 @@
environments by minimizing dependencies.</para>
<para>Achieving link- and run-time coexistence is not a trivial
- implementation task. To achieve this goal we required a small
- extension to the GNU C++ compiler (since incorporated into the C++11 language specification, described in the GCC Manual for the C++ language as
- <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://gcc.gnu.org/onlinedocs/gcc/Namespace-Association.html#Namespace-Association">namespace
- association</link>), and a complex organization of debug- and
- release-modes. The end result is that we have achieved per-use
- recompilation but have had to give up some checking of the
- <code>std::basic_string</code> class template (namely, safe
- iterators).
-</para>
+ implementation task. To achieve this goal we use inline namespaces and
+ a complex organization of debug- and release-modes. The end result is
+ that we have achieved per-use recompilation but have had to give up
+ some checking of the <code>std::basic_string</code> class template
+ (namely, safe iterators).</para>
<section xml:id="methods.coexistence.compile" xreflabel="Compile"><info><title>Compile-time coexistence of release- and debug-mode components</title></info>