1 <section xmlns="http://docbook.org/ns/docbook" version="5.0"
2 xml:id="manual.intro.setup.prereq" xreflabel="Prerequisites">
3 <?dbhtml filename="prerequisites.html"?>
5 <info><title>Prerequisites</title>
19 Because libstdc++ is part of GCC, the primary source for
20 installation instructions is
21 <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://gcc.gnu.org/install/">the GCC install page</link>.
22 In particular, list of prerequisite software needed to build the library
23 <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://gcc.gnu.org/install/prerequisites.html">
24 starts with those requirements.</link> The same pages also list
25 the tools you will need if you wish to modify the source.
29 Additional data is given here only where it applies to libstdc++.
32 <para>As of GCC 4.0.1 the minimum version of binutils required to build
33 libstdc++ is <code>2.15.90.0.1.1</code>. You can get snapshots
34 (as well as releases) of binutils from
35 <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="ftp://sources.redhat.com/pub/binutils/">
36 ftp://sources.redhat.com/pub/binutils</link>.
37 Older releases of libstdc++ do not require such a recent version,
38 but to take full advantage of useful space-saving features and
39 bug-fixes you should use a recent binutils whenever possible.
40 The configure process will automatically detect and use these
41 features if the underlying support is present.
45 To generate the API documentation from the sources you will need
46 Doxygen, see <link linkend="appendix.porting.doc">Documentation
47 Hacking</link> in the appendix for full details.
51 Finally, a few system-specific requirements:
60 If GCC 3.1.0 or later on is being used on GNU/Linux, an attempt
61 will be made to use "C" library functionality necessary for
62 C++ named locale support. For GCC 4.6.0 and later, this
63 means that glibc 2.3 or later is required.
67 If the 'gnu' locale model is being used, the following
68 locales are used and tested in the libstdc++ testsuites.
69 The first column is the name of the locale, the second is
70 the character set it is expected to use.
74 de_DE@euro ISO-8859-15
79 en_US.ISO-8859-1 ISO-8859-1
80 en_US.ISO-8859-15 ISO-8859-15
85 fr_FR@euro ISO-8859-15
89 ru_RU.ISO-8859-5 ISO-8859-5
96 <para>Failure to have installed the underlying "C" library
97 locale information for any of the above regions means that
98 the corresponding C++ named locale will not work: because of
99 this, the libstdc++ testsuite will skip named locale tests
100 which need missing information. If this isn't an issue, don't
101 worry about it. If a named locale is needed, the underlying
102 locale information must be installed. Note that rebuilding
103 libstdc++ after "C" locales are installed is not necessary.
107 To install support for locales, do only one of the following:
112 <para>install all locales</para>
115 <para>install just the necessary locales</para>
118 <para>with Debian GNU/Linux:</para>
119 <para> Add the above list, as shown, to the file
120 <code>/etc/locale.gen</code> </para>
121 <para> run <code>/usr/sbin/locale-gen</code> </para>
124 <para>on most Unix-like operating systems:</para>
125 <para><code> localedef -i de_DE -f ISO-8859-1 de_DE </code></para>
126 <para>(repeat for each entry in the above list) </para>
130 Instructions for other operating systems solicited.