diff options
Diffstat (limited to 'libstdc++-v3/doc/xml/manual/build_hacking.xml')
| -rw-r--r-- | libstdc++-v3/doc/xml/manual/build_hacking.xml | 57 |
1 files changed, 28 insertions, 29 deletions
diff --git a/libstdc++-v3/doc/xml/manual/build_hacking.xml b/libstdc++-v3/doc/xml/manual/build_hacking.xml index fd134bdea45..0746392a2b5 100644 --- a/libstdc++-v3/doc/xml/manual/build_hacking.xml +++ b/libstdc++-v3/doc/xml/manual/build_hacking.xml @@ -1,7 +1,8 @@ -<sect1 id="appendix.porting.build_hacking" xreflabel="Build Hacking"> +<section xmlns="http://docbook.org/ns/docbook" version="5.0" + xml:id="appendix.porting.build_hacking" xreflabel="Build Hacking"> <?dbhtml filename="build_hacking.html"?> -<sect1info> +<info><title>Configure and Build Hacking</title> <keywordset> <keyword> C++ @@ -19,15 +20,14 @@ shared </keyword> </keywordset> -</sect1info> +</info> -<title>Configure and Build Hacking</title> -<sect2 id="build_hacking.prereq"> - <title>Prerequisites</title> + +<section xml:id="build_hacking.prereq"><info><title>Prerequisites</title></info> + <para> - As noted <ulink - url="http://gcc.gnu.org/install/prerequisites.html">previously</ulink>, + As noted <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://gcc.gnu.org/install/prerequisites.html">previously</link>, certain other tools are necessary for hacking on files that control configure (<code>configure.ac</code>, <code>acinclude.m4</code>) and make @@ -38,10 +38,10 @@ the auto-tools used, so please try to play nicely with the neighbors. </para> -</sect2> +</section> -<sect2 id="build_hacking.map"> - <title>Overview: What Comes from Where</title> +<section xml:id="build_hacking.map"><info><title>Overview: What Comes from Where</title></info> + <screen> <inlinemediaobject> @@ -61,14 +61,14 @@ <code>"aclocal-1.11 && autoconf-2.64 && autoheader-2.64 && automake-1.11"</code> The version numbers may be absent entirely or otherwise vary depending on - <ulink url="http://gcc.gnu.org/install/prerequisites.html">the - current requirements</ulink> and your vendor's choice of + <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://gcc.gnu.org/install/prerequisites.html">the + current requirements</link> and your vendor's choice of installation names. </para> -</sect2> +</section> -<sect2 id="build_hacking.scripts"> - <title>Storing Information in non-AC files (like configure.host)</title> +<section xml:id="build_hacking.scripts"><info><title>Storing Information in non-AC files (like configure.host)</title></info> + <para> Until that glorious day when we can use AC_TRY_LINK with a @@ -97,10 +97,10 @@ to properly find them all when generating configure. I would discourage that. </para> -</sect2> +</section> -<sect2 id="build_hacking.conventions"> - <title>Coding and Commenting Conventions</title> +<section xml:id="build_hacking.conventions"><info><title>Coding and Commenting Conventions</title></info> + <para> Most comments should use {octothorpes, shibboleths, hash marks, @@ -122,10 +122,10 @@ <code>$target_alias</code>. The single exception is in configure.ac, for automake+dejagnu's sake. </para> -</sect2> +</section> -<sect2 id="build_hacking.acinclude"> - <title>The acinclude.m4 layout</title> +<section xml:id="build_hacking.acinclude"><info><title>The acinclude.m4 layout</title></info> + <para> The nice thing about acinclude.m4/aclocal.m4 is that macros aren't actually performed/called/expanded/whatever here, just loaded. So @@ -213,10 +213,10 @@ present otherwise stuff magically goes wonky. </para> -</sect2> +</section> -<sect2 id="build_hacking.enable"> - <title><constant>GLIBCXX_ENABLE</constant>, the <literal>--enable</literal> maker</title> +<section xml:id="build_hacking.enable"><info><title><constant>GLIBCXX_ENABLE</constant>, the <literal>--enable</literal> maker</title></info> + <para> All the GLIBCXX_ENABLE_FOO macros use a common helper, @@ -304,8 +304,7 @@ <para> If you're wondering what that line noise in the last example was, that's how you embed autoconf special characters in output text. - They're called <ulink - url="http://www.gnu.org/software/autoconf/manual/autoconf.html#Quadrigraphs"><emphasis>quadrigraphs</emphasis></ulink> + They're called <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://www.gnu.org/software/autoconf/manual/autoconf.html#Quadrigraphs"><emphasis>quadrigraphs</emphasis></link> and you should use them whenever necessary. </para> </listitem> @@ -349,6 +348,6 @@ message. </para> -</sect2> +</section> -</sect1> +</section> |