public inbox for gcc-cvs@sourceware.org
help / color / mirror / Atom feed
* [gcc r14-4092] libstdc++: Minor update to installation docs
@ 2023-09-18 11:17 Jonathan Wakely
0 siblings, 0 replies; only message in thread
From: Jonathan Wakely @ 2023-09-18 11:17 UTC (permalink / raw)
To: gcc-cvs, libstdc++-cvs
https://gcc.gnu.org/g:12755fe40b2474554a01815b18c6b9956a513137
commit r14-4092-g12755fe40b2474554a01815b18c6b9956a513137
Author: Jonathan Wakely <jwakely@redhat.com>
Date: Mon Sep 18 12:14:15 2023 +0100
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.
Diff:
---
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/html/manual/setup.html b/libstdc++-v3/doc/html/manual/setup.html
index f27b8d806df..1963cdf695a 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 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>
^ permalink raw reply [flat|nested] only message in thread
only message in thread, other threads:[~2023-09-18 11:17 UTC | newest]
Thread overview: (only message) (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2023-09-18 11:17 [gcc r14-4092] libstdc++: Minor update to installation docs Jonathan Wakely
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).