libstdc++: Minor update to installation docs

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.
author: Jonathan Wakely <jwakely@redhat.com> 2023-09-18 12:14:15 +0100
committer: Jonathan Wakely <jwakely@redhat.com> 2023-09-18 12:15:34 +0100
commit: 12755fe40b2474554a01815b18c6b9956a513137 (patch)
tree: e72790a4c9547d446409a7e94ab0c33e2c8c6fa7
parent: 8fbc0871da26fac1668ba939f4492876794734ac (diff)
download: gcc-12755fe40b2474554a01815b18c6b9956a513137.zip
gcc-12755fe40b2474554a01815b18c6b9956a513137.tar.gz
gcc-12755fe40b2474554a01815b18c6b9956a513137.tar.bz2
3 files changed, 42 insertions, 15 deletions
diff --git a/libstdc++-v3/doc/html/manual/setup.html b/libstdc++-v3/doc/html/manual/setup.html
index f27b8d8..1963cdf 100644
--- a/libstdc++-v3/doc/html/manual/setup.html
+++ b/libstdc++-v3/doc/html/manual/setup.html
@@ -2,11 +2,11 @@
 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>Chapter 2. Setup</title><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot" /><meta name="keywords" content="ISO C++, library" /><meta name="keywords" content="ISO C++, runtime, library" /><link rel="home" href="../index.html" title="The GNU C++ Library" /><link rel="up" href="intro.html" title="Part I.  Introduction" /><link rel="prev" href="bugs.html" title="Bugs" /><link rel="next" href="configure.html" title="Configure" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Chapter 2. Setup</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="bugs.html">Prev</a> </td><th width="60%" align="center">Part I. 
   Introduction
   
-</th><td width="20%" align="right"> <a accesskey="n" href="configure.html">Next</a></td></tr></table><hr /></div><div class="chapter"><div class="titlepage"><div><div><h2 class="title"><a id="manual.intro.setup"></a>Chapter 2. Setup</h2></div></div></div><div class="toc"><p><strong>Table of Contents</strong></p><dl class="toc"><dt><span class="section"><a href="setup.html#manual.intro.setup.prereq">Prerequisites</a></span></dt><dt><span class="section"><a href="configure.html">Configure</a></span></dt><dt><span class="section"><a href="make.html">Make</a></span></dt></dl></div><p>To transform libstdc++ sources into installed include files
+</th><td width="20%" align="right"> <a accesskey="n" href="configure.html">Next</a></td></tr></table><hr /></div><div class="chapter"><div class="titlepage"><div><div><h2 class="title"><a id="manual.intro.setup"></a>Chapter 2. Setup</h2></div></div></div><div class="toc"><p><strong>Table of Contents</strong></p><dl class="toc"><dt><span class="section"><a href="setup.html#manual.intro.setup.prereq">Prerequisites</a></span></dt><dt><span class="section"><a href="configure.html">Configure</a></span></dt><dt><span class="section"><a href="make.html">Make</a></span></dt></dl></div><p>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.
-   </p><p>The general outline of commands is something like:
+   done as part of building GCC. Building libstdc++ separately from the
+   rest of GCC is not supported.
+   </p><p>The general outline of commands to build GCC is something like:
    </p><pre class="programlisting">
    <em class="replaceable"><code>get gcc sources</code></em>
    <em class="replaceable"><code>extract into gccsrcdir</code></em>
@@ -77,8 +77,10 @@ ln -s libiconv-1.16 libiconv
 	    </p></li></ul></div><p>
 	  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 <code class="function">newlocale</code>
+	  and <code class="function">uselocale</code> functions.
+	  For GCC 4.6.0 and later,
+	  this means that glibc 2.3 or later is required.
 	</p><p>
 	  If the 'gnu' locale model is being used, the following
 	  locales are used and tested in the libstdc++ testsuites.
@@ -116,7 +118,17 @@ zh_TW               BIG5
       libstdc++ after "C" locales are installed is not necessary.
       </p><p>
 	To install support for locales, do only one of the following:
-      </p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>install all locales</p></li><li class="listitem"><p>install just the necessary locales</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: circle; "><li class="listitem"><p>with Debian GNU/Linux:</p><p> Add the above list, as shown, to the file
+      </p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>install all locales, e.g., run
+	    <code class="code"> dnf install glibc-all-langpacks </code>
+	    for Fedora and related distributions.
+	  </p></li><li class="listitem"><p>install just the necessary locales</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: circle; "><li class="listitem"><p>with Debian GNU/Linux:</p><p> Add the above list, as shown, to the file
 	      <code class="code">/etc/locale.gen</code> </p><p> run <code class="code">/usr/sbin/locale-gen</code> </p></li><li class="listitem"><p>on most Unix-like operating systems:</p><p><code class="code"> localedef -i de_DE -f ISO-8859-1 de_DE </code></p><p>(repeat for each entry in the above list) </p></li><li class="listitem"><p>
 	       Instructions for other operating systems solicited.
-	    </p></li></ul></div></li></ul></div></dd></dl></div></div></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="bugs.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="intro.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="configure.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Bugs </td><td width="20%" align="center"><a accesskey="h" href="../index.html">Home</a></td><td width="40%" align="right" valign="top"> Configure</td></tr></table></div></body></html>
-\ No newline at end of file
+	    </p></li></ul></div></li></ul></div>
+	Some tests for the <code class="code">std::messages</code> facet require a
+	message catalog created by the <span class="command"><strong>msgfmt</strong></span> utility.
+	That is usually installed as part of the GNU gettext library.
+	If <span class="command"><strong>msgfmt</strong></span> is not available, some tests under
+	the <code class="filename">22_locale/messages</code>
+	directory will fail.
+      </dd></dl></div></div></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="bugs.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="intro.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="configure.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Bugs </td><td width="20%" align="center"><a accesskey="h" href="../index.html">Home</a></td><td width="40%" align="right" valign="top"> Configure</td></tr></table></div></body></html>
+\ No newline at end of file
diff --git a/libstdc++-v3/doc/xml/manual/intro.xml b/libstdc++-v3/doc/xml/manual/intro.xml
index 03d5385..f5037ac 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 f00979a..a02d379 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>
author	Jonathan Wakely <jwakely@redhat.com>	2023-09-18 12:14:15 +0100
committer	Jonathan Wakely <jwakely@redhat.com>	2023-09-18 12:15:34 +0100
commit	12755fe40b2474554a01815b18c6b9956a513137 (patch)
tree	e72790a4c9547d446409a7e94ab0c33e2c8c6fa7
parent	8fbc0871da26fac1668ba939f4492876794734ac (diff)
download	gcc-12755fe40b2474554a01815b18c6b9956a513137.zip gcc-12755fe40b2474554a01815b18c6b9956a513137.tar.gz gcc-12755fe40b2474554a01815b18c6b9956a513137.tar.bz2