Pushed to trunk. -- >8 --
libstdc++-v3/ChangeLog: * doc/xml/manual/intro.xml: Clarify that building libstdc++ separately from GCC is not supported. * doc/xml/manual/prerequisites.xml: Note msgfmt prerequisite for testing. * doc/html/manual/setup.html: Regenerate. --- libstdc++-v3/doc/html/manual/setup.html | 28 +++++++++++++------ libstdc++-v3/doc/xml/manual/intro.xml | 8 +++--- libstdc++-v3/doc/xml/manual/prerequisites.xml | 21 ++++++++++++-- 3 files changed, 42 insertions(+), 15 deletions(-) diff --git a/libstdc++-v3/doc/xml/manual/intro.xml b/libstdc++-v3/doc/xml/manual/intro.xml index 03d538546b7..f5037acdb5c 100644 --- a/libstdc++-v3/doc/xml/manual/intro.xml +++ b/libstdc++-v3/doc/xml/manual/intro.xml @@ -1327,13 +1327,13 @@ requirements of the license of GCC. <?dbhtml filename="setup.html"?> - <para>To transform libstdc++ sources into installed include files + <para>Transforming libstdc++ sources into installed include files and properly built binaries useful for linking to other software is - a multi-step process. Steps include getting the sources, - configuring and building the sources, testing, and installation. + done as part of building GCC. Building libstdc++ separately from the + rest of GCC is not supported. </para> - <para>The general outline of commands is something like: + <para>The general outline of commands to build GCC is something like: </para> <programlisting> diff --git a/libstdc++-v3/doc/xml/manual/prerequisites.xml b/libstdc++-v3/doc/xml/manual/prerequisites.xml index f00979a1afa..a02d3795830 100644 --- a/libstdc++-v3/doc/xml/manual/prerequisites.xml +++ b/libstdc++-v3/doc/xml/manual/prerequisites.xml @@ -103,8 +103,10 @@ ln -s libiconv-1.16 libiconv <para> If GCC 3.1.0 or later on is being used on GNU/Linux, an attempt will be made to use "C" library functionality necessary for - C++ named locale support. For GCC 4.6.0 and later, this - means that glibc 2.3 or later is required. + C++ named locale support, e.g. the <function>newlocale</function> + and <function>uselocale</function> functions. + For GCC 4.6.0 and later, + this means that glibc 2.3 or later is required. </para> <para> @@ -153,7 +155,10 @@ zh_TW BIG5 <itemizedlist> <listitem> - <para>install all locales</para> + <para>install all locales, e.g., run + <code> dnf install glibc-all-langpacks </code> + for Fedora and related distributions. + </para> </listitem> <listitem> <para>install just the necessary locales</para> @@ -178,6 +183,16 @@ zh_TW BIG5 </listitem> </itemizedlist> </listitem> + + <listitem> + Some tests for the <code>std::messages</code> facet require a + message catalog created by the <command>msgfmt</command> utility. + That is usually installed as part of the GNU gettext library. + If <command>msgfmt</command> is not available, some tests under + the <filename class="directory">22_locale/messages</filename> + directory will fail. + </listitem> + </varlistentry> </variablelist> -- 2.41.0