commit ed7eeb361974a8c64803b617bd760612060cc3ab
Author: Jonathan Wakely <jwakely@redhat.com>
Date: Wed Apr 19 17:45:42 2017 +0100
Rationalise ABI links in libstdc++ manual
* doc/xml/manual/abi.xml: Rephrase one of the references to the
Itanium C++ ABI.
* doc/xml/manual/test.xml: Document DejaGnu 1.5.3 requirement.
* doc/html/*: Regenerate.
@@ -40,10 +40,9 @@
alignment and in a particular layout, mangling names according to a
well-defined algorithm, has specific arrangements for the support of
virtual functions, etc. These details are defined as the compiler
- Application Binary Interface, or ABI. The GNU C++ compiler uses an
- industry-standard C++ ABI starting with version 3. Details can be
- found in the <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="https://itanium-cxx-abi.github.io/cxx-abi/">ABI
- specification</link>.
+ Application Binary Interface, or ABI. From GCC version 3 onwards the
+ GNU C++ compiler uses an industry-standard C++ ABI, the
+ <link linkend="biblio.cxxabi">Itanium C++ ABI</link>.
</para>
<para>
@@ -1116,7 +1115,7 @@ gcc test.c -g -O2 -L. -lone -ltwo /usr/lib/libstdc++.so.5 /usr/lib/libstdc++.so.
<title>
<link xmlns:xlink="http://www.w3.org/1999/xlink"
xlink:href="https://itanium-cxx-abi.github.io/cxx-abi/">
- C++ ABI Summary
+ Itanium C++ ABI
</link>
</title>
</biblioentry>
@@ -563,8 +563,11 @@ cat 27_io/objects/char/3_xin.in | a.out</programlisting>
the <varname>CXXFLAGS</varname> variable when running
<command>make</command>, or via options for the DejaGnu test framework
(described below). The latter approach uses the
- <option>--target_board</option> option that was shown earlier.
- For example, to run the tests with <option>-O1 -D_GLIBCXX_ASSERTIONS</option>
+ <option>--target_board</option> option that was shown earlier,
+ but requires DejaGnu version 1.5.3 or newer to work reliably, so that the
+ <literal>dg-options</literal> in the test aren't overridden.
+ For example, to run the tests with
+ <option>-O1 -D_GLIBCXX_ASSERTIONS</option>
you could use:
<programlisting> make RUNTESTFLAGS=--target_board=unix/-O1/-D_GLIBCXX_ASSERTIONS</programlisting>
</para>