prerequisites.xml revision 1.1 
1<sect1 id="manual.intro.setup.prereq" xreflabel="Prerequisites">
2<?dbhtml filename="prerequisites.html"?>
3
4<sect1info>
5  <keywordset>
6    <keyword>
7      ISO C++
8    </keyword>
9    <keyword>
10      Prerequisites
11    </keyword>
12  </keywordset>
13</sect1info>
14
15<title>Prerequisites</title>
16
17<para>
18  Because libstdc++ is part of GCC, the primary source for
19   installation instructions is
20   <ulink url="http://gcc.gnu.org/install/">the GCC install page</ulink>.
21   In particular, list of prerequisite software needed to build the library
22   <ulink url="http://gcc.gnu.org/install/prerequisites.html">
23   starts with those requirements.</ulink> The same pages also list
24   the tools you will need if you wish to modify the source.
25</para>
26
27  <para>
28   Additional data is given here only where it applies to libstdc++.
29  </para>
30
31   <para>As of GCC 4.0.1 the minimum version of binutils required to build
32      libstdc++ is <code>2.15.90.0.1.1</code>. You can get snapshots
33      (as well as releases) of binutils from
34      <ulink url="ftp://sources.redhat.com/pub/binutils/">
35      ftp://sources.redhat.com/pub/binutils</ulink>.
36      Older releases of libstdc++ do not require such a recent version,
37      but to take full advantage of useful space-saving features and
38      bug-fixes you should use a recent binutils whenever possible.
39      The configure process will automatically detect and use these
40      features if the underlying support is present.
41   </para>
42
43   <para>
44   Finally, a few system-specific requirements:
45   </para>
46
47   <variablelist>
48      <varlistentry>
49	<term>linux</term>
50
51	<listitem>
52	<para>
53	  If gcc 3.1.0 or later on is being used on linux, an attempt
54	  will be made to use "C" library functionality necessary for
55	  C++ named locale support.  For gcc 3.2.1 and later, this
56	  means that glibc 2.2.5 or later is required and the "C"
57	  library de_DE locale information must be installed.
58	</para>
59
60	<para>
61	  Note however that the sanity checks involving the de_DE
62	  locale are skipped when an explicit --enable-clocale=gnu
63	  configure option is used: only the basic checks are carried
64	  out, defending against misconfigurations.
65	</para>
66
67	<para>
68	  If the 'gnu' locale model is being used, the following
69	  locales are used and tested in the libstdc++ testsuites.
70	  The first column is the name of the locale, the second is
71	  the character set it is expected to use.
72	</para>
73<programlisting>
74de_DE               ISO-8859-1
75de_DE@euro          ISO-8859-15
76en_GB               ISO-8859-1
77en_HK               ISO-8859-1
78en_PH               ISO-8859-1
79en_US               ISO-8859-1
80en_US.ISO-8859-1    ISO-8859-1
81en_US.ISO-8859-15   ISO-8859-15
82en_US.UTF-8         UTF-8
83es_ES               ISO-8859-1
84es_MX               ISO-8859-1
85fr_FR               ISO-8859-1
86fr_FR@euro          ISO-8859-15
87is_IS               UTF-8
88it_IT               ISO-8859-1
89ja_JP.eucjp         EUC-JP
90ru_RU.ISO-8859-5    ISO-8859-5
91ru_RU.UTF-8         UTF-8
92se_NO.UTF-8         UTF-8
93ta_IN               UTF-8
94zh_TW               BIG5
95</programlisting>
96
97      <para>Failure to have the underlying "C" library locale
98      information installed will mean that C++ named locales for the
99      above regions will not work: because of this, the libstdc++
100      testsuite will skip the named locale tests. If this isn't an
101      issue, don't worry about it. If named locales are needed, the
102      underlying locale information must be installed. Note that
103      rebuilding libstdc++ after the "C" locales are installed is not
104      necessary.
105      </para>
106
107      <para>
108	To install support for locales, do only one of the following:
109      </para>
110
111      <itemizedlist>
112	<listitem>
113	  <para>install all locales</para>
114	  <itemizedlist>
115	    <listitem>
116	      <para>with RedHat Linux:
117	      </para>
118	      <para> <code> export LC_ALL=C </code>
119	      </para>
120	      <para> <code> rpm -e glibc-common --nodeps </code>
121	      </para>
122	      <para>
123		<code> rpm -i --define "_install_langs all"
124		 glibc-common-2.2.5-34.i386.rpm
125		</code>
126	      </para>
127	    </listitem>
128	     <listitem>
129	     <para>
130	       Instructions for other operating systems solicited.
131	     </para>
132	     </listitem>
133	  </itemizedlist>
134	</listitem>
135	<listitem>
136	  <para>install just the necessary locales</para>
137	  <itemizedlist>
138	    <listitem>
139	      <para>with Debian Linux:</para>
140	      <para> Add the above list, as shown, to the file
141	      <code>/etc/locale.gen</code> </para>
142	      <para> run <code>/usr/sbin/locale-gen</code> </para>
143	    </listitem>
144	    <listitem>
145	      <para>on most Unix-like operating systems:</para>
146	      <para><code> localedef -i de_DE -f ISO-8859-1 de_DE </code></para>
147	      <para>(repeat for each entry in the above list) </para>
148	    </listitem>
149	    <listitem>
150	    <para>
151	       Instructions for other operating systems solicited.
152	    </para>
153	    </listitem>
154	  </itemizedlist>
155	</listitem>
156      </itemizedlist>
157      </listitem>
158      </varlistentry>
159   </variablelist>
160
161</sect1>
162