Home | History | Annotate | Line # | Download | only in INSTALL
prerequisites.html revision 1.19
      1  1.10    mrg <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
      2  1.10    mrg <html>
      3  1.19    mrg <!-- Copyright (C) 1988-2024 Free Software Foundation, Inc.
      4   1.1    mrg 
      5  1.10    mrg Permission is granted to copy, distribute and/or modify this document
      6   1.3  skrll under the terms of the GNU Free Documentation License, Version 1.3 or
      7   1.1    mrg any later version published by the Free Software Foundation; with no
      8   1.1    mrg Invariant Sections, the Front-Cover texts being (a) (see below), and
      9   1.1    mrg with the Back-Cover Texts being (b) (see below).  A copy of the
     10  1.10    mrg license is included in the section entitled "GNU
     11  1.10    mrg Free Documentation License".
     12   1.1    mrg 
     13   1.1    mrg (a) The FSF's Front-Cover Text is:
     14   1.1    mrg 
     15  1.10    mrg A GNU Manual
     16   1.1    mrg 
     17   1.1    mrg (b) The FSF's Back-Cover Text is:
     18   1.1    mrg 
     19  1.10    mrg You have freedom to copy and modify this GNU Manual, like GNU
     20   1.1    mrg      software.  Copies published by the Free Software Foundation raise
     21  1.10    mrg      funds for GNU development. -->
     22  1.18    mrg <!-- Created by GNU Texinfo 6.5, http://www.gnu.org/software/texinfo/ -->
     23  1.18    mrg <head>
     24  1.18    mrg <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
     25  1.13    mrg <title>Prerequisites for GCC</title>
     26  1.10    mrg 
     27  1.13    mrg <meta name="description" content="Prerequisites for GCC">
     28  1.13    mrg <meta name="keywords" content="Prerequisites for GCC">
     29  1.10    mrg <meta name="resource-type" content="document">
     30  1.10    mrg <meta name="distribution" content="global">
     31  1.10    mrg <meta name="Generator" content="makeinfo">
     32  1.10    mrg <style type="text/css">
     33  1.10    mrg <!--
     34  1.10    mrg a.summary-letter {text-decoration: none}
     35  1.10    mrg blockquote.indentedblock {margin-right: 0em}
     36  1.18    mrg blockquote.smallindentedblock {margin-right: 0em; font-size: smaller}
     37  1.18    mrg blockquote.smallquotation {font-size: smaller}
     38  1.10    mrg div.display {margin-left: 3.2em}
     39  1.10    mrg div.example {margin-left: 3.2em}
     40  1.18    mrg div.lisp {margin-left: 3.2em}
     41  1.18    mrg div.smalldisplay {margin-left: 3.2em}
     42  1.18    mrg div.smallexample {margin-left: 3.2em}
     43  1.18    mrg div.smalllisp {margin-left: 3.2em}
     44  1.10    mrg kbd {font-style: oblique}
     45  1.10    mrg pre.display {font-family: inherit}
     46  1.10    mrg pre.format {font-family: inherit}
     47  1.10    mrg pre.menu-comment {font-family: serif}
     48  1.10    mrg pre.menu-preformatted {font-family: serif}
     49  1.18    mrg pre.smalldisplay {font-family: inherit; font-size: smaller}
     50  1.18    mrg pre.smallexample {font-size: smaller}
     51  1.18    mrg pre.smallformat {font-family: inherit; font-size: smaller}
     52  1.18    mrg pre.smalllisp {font-size: smaller}
     53  1.10    mrg span.nolinebreak {white-space: nowrap}
     54  1.10    mrg span.roman {font-family: initial; font-weight: normal}
     55  1.10    mrg span.sansserif {font-family: sans-serif; font-weight: normal}
     56  1.10    mrg ul.no-bullet {list-style: none}
     57  1.10    mrg -->
     58  1.10    mrg </style>
     59  1.10    mrg 
     60  1.10    mrg 
     61   1.1    mrg </head>
     62  1.10    mrg 
     63  1.10    mrg <body lang="en">
     64  1.13    mrg <h1 class="settitle" align="center">Prerequisites for GCC</h1>
     65  1.10    mrg 
     66  1.10    mrg 
     67  1.10    mrg 
     68  1.10    mrg 
     69  1.10    mrg 
     70  1.10    mrg 
     71  1.10    mrg 
     72  1.10    mrg 
     73  1.10    mrg 
     74  1.10    mrg 
     75  1.10    mrg 
     76  1.10    mrg 
     77  1.10    mrg 
     78  1.10    mrg 
     79  1.10    mrg 
     80  1.10    mrg 
     81  1.10    mrg 
     82  1.19    mrg 
     83  1.19    mrg 
     84  1.19    mrg 
     85  1.18    mrg <a name="index-Prerequisites"></a>
     86  1.10    mrg 
     87  1.10    mrg <p>GCC requires that various tools and packages be available for use in the
     88   1.9    mrg build procedure.  Modifying GCC sources requires additional tools
     89   1.9    mrg described below.
     90  1.10    mrg </p>
     91  1.18    mrg <a name="Tools_002fpackages-necessary-for-building-GCC"></a>
     92  1.18    mrg <h3 class="heading">Tools/packages necessary for building GCC</h3>
     93  1.10    mrg <dl compact="compact">
     94  1.18    mrg <dt>ISO C++11 compiler</dt>
     95  1.16    mrg <dd><p>Necessary to bootstrap GCC.  GCC 4.8.3 or newer has sufficient
     96  1.16    mrg support for used C++11 features, with earlier GCC versions you
     97  1.16    mrg might run into implementation bugs.
     98  1.16    mrg </p>
     99  1.16    mrg <p>Versions of GCC prior to 11 also allow bootstrapping with an ISO C++98
    100  1.16    mrg compiler, versions of GCC prior to 4.8 also allow bootstrapping with a
    101  1.16    mrg ISO C89 compiler, and versions of GCC prior to 3.4 also allow
    102  1.16    mrg bootstrapping with a traditional (K&amp;R) C compiler.
    103  1.10    mrg </p>
    104  1.10    mrg <p>To build all languages in a cross-compiler or other configuration where
    105   1.1    mrg 3-stage bootstrap is not performed, you need to start with an existing
    106  1.16    mrg GCC binary (version 4.8.3 or later) because source code for language
    107   1.1    mrg frontends other than C might use GCC extensions.
    108  1.10    mrg </p>
    109  1.10    mrg </dd>
    110  1.18    mrg <dt>C standard library and headers</dt>
    111  1.10    mrg <dd>
    112  1.10    mrg <p>In order to build GCC, the C standard library and headers must be present
    113   1.5    mrg for all target variants for which target libraries will be built (and not
    114   1.5    mrg only the variant of the host C++ compiler).
    115  1.10    mrg </p>
    116  1.12    mrg <p>This affects the popular &lsquo;<samp>x86_64-pc-linux-gnu</samp>&rsquo; platform (among
    117  1.10    mrg other multilib targets), for which 64-bit (&lsquo;<samp>x86_64</samp>&rsquo;) and 32-bit
    118  1.10    mrg (&lsquo;<samp>i386</samp>&rsquo;) libc headers are usually packaged separately. If you do a
    119  1.12    mrg build of a native compiler on &lsquo;<samp>x86_64-pc-linux-gnu</samp>&rsquo;, make sure you
    120   1.5    mrg either have the 32-bit libc developer package properly installed (the exact
    121   1.5    mrg name of the package depends on your distro) or you must build GCC as a
    122   1.5    mrg 64-bit only compiler by configuring with the option
    123  1.10    mrg <samp>--disable-multilib</samp>.  Otherwise, you may encounter an error such as
    124  1.10    mrg &lsquo;<samp>fatal error: gnu/stubs-32.h: No such file</samp>&rsquo;
    125  1.10    mrg </p>
    126  1.10    mrg </dd>
    127  1.19    mrg <dt>Python</dt>
    128  1.19    mrg <dd><p>If you configure a RISC-V compiler with the option <samp>--with-arch</samp> and
    129  1.19    mrg the specified architecture string is non-canonical, then you will need
    130  1.19    mrg <code>python</code> installed on the build system.
    131  1.19    mrg </p>
    132  1.19    mrg </dd>
    133  1.18    mrg <dt><a name="GNAT-prerequisite"></a>GNAT</dt>
    134  1.10    mrg <dd>
    135  1.13    mrg <p>In order to build GNAT, the Ada compiler, you need a working GNAT
    136  1.16    mrg compiler (GCC version 5.1 or later).
    137  1.13    mrg </p>
    138  1.13    mrg <p>This includes GNAT tools such as <code>gnatmake</code> and
    139  1.13    mrg <code>gnatlink</code>, since the Ada front end is written in Ada and
    140  1.13    mrg uses some GNAT-specific extensions.
    141  1.13    mrg </p>
    142  1.13    mrg <p>In order to build a cross compiler, it is strongly recommended to install
    143  1.13    mrg the new compiler as native first, and then use it to build the cross
    144  1.13    mrg compiler. Other native compiler versions may work but this is not guaranteed and
    145  1.13    mrg will typically fail with hard to understand compilation errors during the
    146  1.13    mrg build.
    147  1.13    mrg </p>
    148  1.13    mrg <p>Similarly, it is strongly recommended to use an older version of GNAT to build
    149  1.13    mrg GNAT. More recent versions of GNAT than the version built are not guaranteed
    150  1.13    mrg to work and will often fail during the build with compilation errors.
    151  1.13    mrg </p>
    152  1.13    mrg <p>Note that <code>configure</code> does not test whether the GNAT installation works
    153  1.13    mrg and has a sufficiently recent version; if too old a GNAT version is
    154  1.13    mrg installed and <samp>--enable-languages=ada</samp> is used, the build will fail.
    155  1.13    mrg </p>
    156  1.13    mrg <p><code>ADA_INCLUDE_PATH</code> and <code>ADA_OBJECT_PATH</code> environment variables
    157  1.13    mrg must not be set when building the Ada compiler, the Ada tools, or the
    158  1.13    mrg Ada runtime libraries. You can check that your build environment is clean
    159  1.13    mrg by verifying that &lsquo;<samp>gnatls -v</samp>&rsquo; lists only one explicit path in each
    160  1.13    mrg section.
    161  1.10    mrg </p>
    162  1.10    mrg </dd>
    163  1.18    mrg <dt><a name="GDC-prerequisite"></a>GDC</dt>
    164  1.16    mrg <dd>
    165  1.16    mrg <p>In order to build GDC, the D compiler, you need a working GDC
    166  1.16    mrg compiler (GCC version 9.4 or later) and D runtime library,
    167  1.16    mrg &lsquo;<samp>libphobos</samp>&rsquo;, as the D front end is written in D.
    168  1.16    mrg </p>
    169  1.16    mrg <p>Versions of GDC prior to 12 can be built with an ISO C++11 compiler, which can
    170  1.16    mrg then be installed and used to bootstrap newer versions of the D front end.
    171  1.16    mrg </p>
    172  1.16    mrg <p>It is strongly recommended to use an older version of GDC to build GDC. More
    173  1.16    mrg recent versions of GDC than the version built are not guaranteed to work and
    174  1.16    mrg will often fail during the build with compilation errors relating to
    175  1.16    mrg deprecations or removed features.
    176  1.16    mrg </p>
    177  1.16    mrg <p>Note that <code>configure</code> does not test whether the GDC installation works
    178  1.16    mrg and has a sufficiently recent version.  Though the implementation of the D
    179  1.16    mrg front end does not make use of any GDC-specific extensions, or novel features
    180  1.16    mrg of the D language, if too old a GDC version is installed and
    181  1.16    mrg <samp>--enable-languages=d</samp> is used, the build will fail.
    182  1.16    mrg </p>
    183  1.16    mrg <p>On some targets, &lsquo;<samp>libphobos</samp>&rsquo; isn&rsquo;t enabled by default, but compiles
    184  1.16    mrg and works if <samp>--enable-libphobos</samp> is used.  Specifics are
    185  1.16    mrg documented for affected targets.
    186  1.16    mrg </p>
    187  1.16    mrg </dd>
    188  1.19    mrg <dt><a name="GM2-prerequisite"></a>GM2</dt>
    189  1.19    mrg <dd>
    190  1.19    mrg <p>Python3 is required if you want to build the complete Modula-2
    191  1.19    mrg documentation including the target <code>SYSTEM</code> definition module.
    192  1.19    mrg If Python3 is unavailable Modula-2 documentation will include a target
    193  1.19    mrg independent version of the SYSTEM modules.
    194  1.19    mrg </p>
    195  1.19    mrg </dd>
    196  1.18    mrg <dt>A &ldquo;working&rdquo; POSIX compatible shell, or GNU bash</dt>
    197  1.10    mrg <dd>
    198  1.10    mrg <p>Necessary when running <code>configure</code> because some
    199  1.10    mrg <code>/bin/sh</code> shells have bugs and may crash when configuring the
    200  1.10    mrg target libraries.  In other cases, <code>/bin/sh</code> or <code>ksh</code>
    201   1.1    mrg have disastrous corner-case performance problems.  This
    202  1.10    mrg can cause target <code>configure</code> runs to literally take days to
    203   1.1    mrg complete in some cases.
    204  1.10    mrg </p>
    205  1.10    mrg <p>So on some platforms <code>/bin/ksh</code> is sufficient, on others it
    206  1.10    mrg isn&rsquo;t.  See the host/target specific instructions for your platform, or
    207  1.10    mrg use <code>bash</code> to be sure.  Then set <code>CONFIG_SHELL</code> in your
    208   1.1    mrg environment to your &ldquo;good&rdquo; shell prior to running
    209  1.10    mrg <code>configure</code>/<code>make</code>.
    210  1.10    mrg </p>
    211  1.10    mrg <p><code>zsh</code> is not a fully compliant POSIX shell and will not
    212   1.1    mrg work when configuring GCC.
    213  1.10    mrg </p>
    214  1.10    mrg </dd>
    215  1.19    mrg <dt>GNU flex</dt>
    216  1.19    mrg <dd>
    217  1.19    mrg <p>Necessary to build the lexical analysis module.
    218  1.19    mrg </p>
    219  1.19    mrg </dd>
    220  1.18    mrg <dt>A POSIX or SVR4 awk</dt>
    221  1.10    mrg <dd>
    222  1.10    mrg <p>Necessary for creating some of the generated source files for GCC.
    223   1.1    mrg If in doubt, use a recent GNU awk version, as some of the older ones
    224   1.1    mrg are broken.  GNU awk version 3.1.5 is known to work.
    225  1.10    mrg </p>
    226  1.10    mrg </dd>
    227  1.18    mrg <dt>GNU binutils</dt>
    228  1.10    mrg <dd>
    229  1.10    mrg <p>Necessary in some circumstances, optional in others.  See the
    230   1.1    mrg host/target specific instructions for your platform for the exact
    231   1.1    mrg requirements.
    232  1.10    mrg </p>
    233  1.16    mrg <p>Note binutils 2.35 or newer is required for LTO to work correctly
    234  1.16    mrg with GNU libtool that includes doing a bootstrap with LTO enabled.
    235  1.16    mrg </p>
    236  1.10    mrg </dd>
    237  1.18    mrg <dt>gzip version 1.2.4 (or later) or</dt>
    238  1.18    mrg <dt>bzip2 version 1.0.2 (or later)</dt>
    239  1.10    mrg <dd>
    240  1.10    mrg <p>Necessary to uncompress GCC <code>tar</code> files when source code is
    241  1.13    mrg obtained via HTTPS mirror sites.
    242  1.10    mrg </p>
    243  1.10    mrg </dd>
    244  1.18    mrg <dt>GNU make version 3.80 (or later)</dt>
    245  1.10    mrg <dd>
    246  1.10    mrg <p>You must have GNU make installed to build GCC.
    247  1.10    mrg </p>
    248  1.10    mrg </dd>
    249  1.18    mrg <dt>GNU tar version 1.14 (or later)</dt>
    250  1.10    mrg <dd>
    251  1.10    mrg <p>Necessary (only on some platforms) to untar the source code.  Many
    252  1.10    mrg systems&rsquo; <code>tar</code> programs will also work, only try GNU
    253  1.10    mrg <code>tar</code> if you have problems.
    254  1.10    mrg </p>
    255  1.10    mrg </dd>
    256  1.19    mrg <dt>Perl version 5.6.1 (or later)</dt>
    257  1.10    mrg <dd>
    258  1.10    mrg <p>Necessary when targeting Darwin, building &lsquo;<samp>libstdc++</samp>&rsquo;,
    259  1.10    mrg and not using <samp>--disable-symvers</samp>.
    260  1.19    mrg Necessary when targeting Solaris with Solaris <code>ld</code> and not using
    261  1.13    mrg <samp>--disable-symvers</samp>.
    262  1.10    mrg </p>
    263  1.10    mrg <p>Necessary when regenerating <samp>Makefile</samp> dependencies in libiberty.
    264  1.10    mrg Necessary when regenerating <samp>libiberty/functions.texi</samp>.
    265  1.10    mrg Necessary when generating manpages from Texinfo manuals.
    266  1.11    mrg Used by various scripts to generate some files included in the source
    267  1.11    mrg repository (mainly Unicode-related and rarely changing) from source
    268  1.11    mrg tables.
    269  1.10    mrg </p>
    270  1.10    mrg <p>Used by <code>automake</code>.
    271  1.10    mrg </p>
    272  1.17    mrg <p>If available, enables parallel testing of &lsquo;<samp>libgomp</samp>&rsquo; in case that
    273  1.17    mrg <code>flock</code> is not available.
    274  1.17    mrg </p>
    275  1.10    mrg </dd>
    276   1.3  skrll </dl>
    277   1.3  skrll 
    278  1.10    mrg <p>Several support libraries are necessary to build GCC, some are required,
    279   1.3  skrll others optional.  While any sufficiently new version of required tools
    280   1.3  skrll usually work, library requirements are generally stricter.  Newer
    281  1.10    mrg versions may work in some cases, but it&rsquo;s safer to use the exact
    282   1.3  skrll versions documented.  We appreciate bug reports about problems with
    283   1.3  skrll newer versions, though.  If your OS vendor provides packages for the
    284   1.3  skrll support libraries then using those packages may be the simplest way to
    285   1.3  skrll install the libraries.
    286  1.10    mrg </p>
    287  1.10    mrg <dl compact="compact">
    288  1.18    mrg <dt>GNU Multiple Precision Library (GMP) version 4.3.2 (or later)</dt>
    289  1.10    mrg <dd>
    290  1.19    mrg <p>Necessary to build GCC.  It can be downloaded from
    291  1.19    mrg <a href="https://gmplib.org/">https://gmplib.org/</a>.  If a GMP source distribution is found in a
    292  1.10    mrg subdirectory of your GCC sources named <samp>gmp</samp>, it will be built
    293   1.3  skrll together with GCC.  Alternatively, if GMP is already installed but it
    294   1.3  skrll is not in your library search path, you will have to configure with the
    295  1.10    mrg <samp>--with-gmp</samp> configure option.  See also <samp>--with-gmp-lib</samp>
    296  1.10    mrg and <samp>--with-gmp-include</samp>.
    297   1.9    mrg The in-tree build is only supported with the GMP version that
    298   1.9    mrg download_prerequisites installs.
    299  1.10    mrg </p>
    300  1.10    mrg </dd>
    301  1.18    mrg <dt>MPFR Library version 3.1.0 (or later)</dt>
    302  1.10    mrg <dd>
    303  1.10    mrg <p>Necessary to build GCC.  It can be downloaded from
    304  1.12    mrg <a href="https://www.mpfr.org">https://www.mpfr.org</a>.  If an MPFR source distribution is found
    305  1.10    mrg in a subdirectory of your GCC sources named <samp>mpfr</samp>, it will be
    306   1.3  skrll built together with GCC.  Alternatively, if MPFR is already installed
    307   1.3  skrll but it is not in your default library search path, the
    308  1.10    mrg <samp>--with-mpfr</samp> configure option should be used.  See also
    309  1.10    mrg <samp>--with-mpfr-lib</samp> and <samp>--with-mpfr-include</samp>.
    310   1.9    mrg The in-tree build is only supported with the MPFR version that
    311   1.9    mrg download_prerequisites installs.
    312  1.10    mrg </p>
    313  1.10    mrg </dd>
    314  1.18    mrg <dt>MPC Library version 1.0.1 (or later)</dt>
    315  1.10    mrg <dd>
    316  1.10    mrg <p>Necessary to build GCC.  It can be downloaded from
    317  1.16    mrg <a href="https://www.multiprecision.org/mpc/">https://www.multiprecision.org/mpc/</a>.  If an MPC source distribution
    318  1.10    mrg is found in a subdirectory of your GCC sources named <samp>mpc</samp>, it
    319   1.3  skrll will be built together with GCC.  Alternatively, if MPC is already
    320   1.3  skrll installed but it is not in your default library search path, the
    321  1.10    mrg <samp>--with-mpc</samp> configure option should be used.  See also
    322  1.10    mrg <samp>--with-mpc-lib</samp> and <samp>--with-mpc-include</samp>.
    323   1.9    mrg The in-tree build is only supported with the MPC version that
    324   1.9    mrg download_prerequisites installs.
    325  1.10    mrg </p>
    326  1.10    mrg </dd>
    327  1.18    mrg <dt>isl Library version 0.15 or later.</dt>
    328  1.10    mrg <dd>
    329  1.10    mrg <p>Necessary to build GCC with the Graphite loop optimizations.
    330  1.13    mrg It can be downloaded from <a href="https://gcc.gnu.org/pub/gcc/infrastructure/">https://gcc.gnu.org/pub/gcc/infrastructure/</a>.
    331   1.7    mrg If an isl source distribution is found
    332  1.10    mrg in a subdirectory of your GCC sources named <samp>isl</samp>, it will be
    333  1.10    mrg built together with GCC.  Alternatively, the <samp>--with-isl</samp> configure
    334   1.7    mrg option should be used if isl is not installed in your default library
    335   1.5    mrg search path.
    336  1.10    mrg </p>
    337  1.10    mrg </dd>
    338  1.18    mrg <dt>zstd Library.</dt>
    339  1.13    mrg <dd>
    340  1.13    mrg <p>Necessary to build GCC with zstd compression used for LTO bytecode.
    341  1.13    mrg The library is searched in your default library patch search.
    342  1.13    mrg Alternatively, the <samp>--with-zstd</samp> configure option should be used.
    343  1.13    mrg </p>
    344  1.13    mrg </dd>
    345  1.19    mrg <dt>Python3 modules</dt>
    346  1.19    mrg <dd>
    347  1.19    mrg <p>The complete list of Python3 modules broken down by GCC subcomponent
    348  1.19    mrg is shown below:
    349  1.19    mrg </p>
    350  1.19    mrg <dl compact="compact">
    351  1.19    mrg <dt>internal debugging in gdbhooks</dt>
    352  1.19    mrg <dd><p><code>gdb</code>, <code>gdb.printing</code>, <code>gdb.types</code>,
    353  1.19    mrg <code>os.path</code>, <code>re</code>, <code>sys</code> and <code>tempfile</code>,
    354  1.19    mrg </p>
    355  1.19    mrg </dd>
    356  1.19    mrg <dt>g++ testsuite</dt>
    357  1.19    mrg <dd><p><code>gcov</code>, <code>gzip</code>, <code>json</code>, <code>os</code> and <code>pytest</code>.
    358  1.19    mrg </p>
    359  1.19    mrg </dd>
    360  1.19    mrg <dt>SARIF testsuite</dt>
    361  1.19    mrg <dd><p>Tests of SARIF output will use the <code>check-jsonschema</code> program from
    362  1.19    mrg the <code>check-jsonschema</code> module (if available) to validate generated
    363  1.19    mrg .sarif files.  If this tool is not found, the validation parts of those
    364  1.19    mrg tests are skipped.
    365  1.19    mrg </p>
    366  1.19    mrg </dd>
    367  1.19    mrg <dt>c++ cxx api generation</dt>
    368  1.19    mrg <dd><p><code>csv</code>, <code>os</code>, <code>sys</code> and <code>time</code>.
    369  1.19    mrg </p>
    370  1.19    mrg </dd>
    371  1.19    mrg <dt>modula-2 documentation</dt>
    372  1.19    mrg <dd><p><code>argparse</code>, <code>os</code>, <code>pathlib</code>, <code>shutil</code> and
    373  1.19    mrg <code>sys</code>.
    374  1.19    mrg </p>
    375  1.19    mrg </dd>
    376  1.19    mrg <dt>git developer tools</dt>
    377  1.19    mrg <dd><p><code>os</code> and <code>sys</code>.
    378  1.19    mrg </p>
    379  1.19    mrg </dd>
    380  1.19    mrg <dt>ada documentation</dt>
    381  1.19    mrg <dd><p><code>latex_elements</code>, <code>os</code>, <code>pygments</code>, <code>re</code>,
    382  1.19    mrg <code>sys</code> and <code>time</code>.
    383  1.19    mrg </p></dd>
    384  1.19    mrg </dl>
    385  1.19    mrg 
    386  1.19    mrg </dd>
    387  1.19    mrg <dt>GNU gettext</dt>
    388  1.19    mrg <dd>
    389  1.19    mrg <p>Necessary to build GCC with internationalization support via
    390  1.19    mrg <samp>--enable-nls</samp>.  It can be downloaded from
    391  1.19    mrg <a href="https://www.gnu.org/software/gettext/">https://www.gnu.org/software/gettext/</a>. If a GNU gettext distribution
    392  1.19    mrg is found in a subdirectory of your GCC sources named <samp>gettext</samp>, it
    393  1.19    mrg will be built together with GCC, unless present in the system (either in
    394  1.19    mrg libc or as a stand-alone library).
    395  1.19    mrg </p>
    396  1.19    mrg <p>The in-tree configuration requires GNU gettext version 0.22 or later.
    397  1.19    mrg </p>
    398  1.19    mrg </dd>
    399  1.10    mrg </dl>
    400   1.1    mrg 
    401  1.18    mrg <a name="Tools_002fpackages-necessary-for-modifying-GCC"></a>
    402  1.18    mrg <h3 class="heading">Tools/packages necessary for modifying GCC</h3>
    403  1.10    mrg <dl compact="compact">
    404  1.18    mrg <dt>autoconf version 2.69</dt>
    405  1.18    mrg <dt>GNU m4 version 1.4.6 (or later)</dt>
    406  1.10    mrg <dd>
    407  1.10    mrg <p>Necessary when modifying <samp>configure.ac</samp>, <samp>aclocal.m4</samp>, etc.
    408  1.10    mrg to regenerate <samp>configure</samp> and <samp>config.in</samp> files.
    409  1.10    mrg </p>
    410  1.10    mrg </dd>
    411  1.18    mrg <dt>automake version 1.15.1</dt>
    412  1.10    mrg <dd>
    413  1.10    mrg <p>Necessary when modifying a <samp>Makefile.am</samp> file to regenerate its
    414  1.10    mrg associated <samp>Makefile.in</samp>.
    415  1.10    mrg </p>
    416  1.10    mrg <p>Much of GCC does not use automake, so directly edit the <samp>Makefile.in</samp>
    417  1.10    mrg file.  Specifically this applies to the <samp>gcc</samp>, <samp>intl</samp>,
    418  1.10    mrg <samp>libcpp</samp>, <samp>libiberty</samp>, <samp>libobjc</samp> directories as well
    419   1.1    mrg as any of their subdirectories.
    420  1.10    mrg </p>
    421  1.10    mrg <p>For directories that use automake, GCC requires the latest release in
    422  1.12    mrg the 1.15 series, which is currently 1.15.1.  When regenerating a directory
    423  1.12    mrg to a newer version, please update all the directories using an older 1.15
    424   1.1    mrg to the latest released version.
    425  1.10    mrg </p>
    426  1.10    mrg </dd>
    427  1.18    mrg <dt>gettext version 0.14.5 (or later)</dt>
    428  1.10    mrg <dd>
    429  1.10    mrg <p>Needed to regenerate <samp>gcc.pot</samp>.
    430  1.10    mrg </p>
    431  1.10    mrg </dd>
    432  1.18    mrg <dt>gperf version 2.7.2 (or later)</dt>
    433  1.10    mrg <dd>
    434  1.10    mrg <p>Necessary when modifying <code>gperf</code> input files, e.g.
    435  1.10    mrg <samp>gcc/cp/cfns.gperf</samp> to regenerate its associated header file, e.g.
    436  1.10    mrg <samp>gcc/cp/cfns.h</samp>.
    437  1.10    mrg </p>
    438  1.10    mrg </dd>
    439  1.18    mrg <dt>DejaGnu version 1.5.3 (or later)</dt>
    440  1.18    mrg <dt>Expect</dt>
    441  1.18    mrg <dt>Tcl</dt>
    442  1.10    mrg <dd>
    443  1.10    mrg <p>Necessary to run the GCC testsuite; see the section on testing for
    444  1.13    mrg details.
    445  1.10    mrg </p>
    446  1.10    mrg </dd>
    447  1.18    mrg <dt>autogen version 5.5.4 (or later) and</dt>
    448  1.18    mrg <dt>guile version 1.4.1 (or later)</dt>
    449  1.10    mrg <dd>
    450  1.10    mrg <p>Necessary to regenerate <samp>fixinc/fixincl.x</samp> from
    451  1.10    mrg <samp>fixinc/inclhack.def</samp> and <samp>fixinc/*.tpl</samp>.
    452  1.10    mrg </p>
    453  1.10    mrg <p>Necessary to run &lsquo;<samp>make check</samp>&rsquo; for <samp>fixinc</samp>.
    454  1.10    mrg </p>
    455  1.10    mrg <p>Necessary to regenerate the top level <samp>Makefile.in</samp> file from
    456  1.10    mrg <samp>Makefile.tpl</samp> and <samp>Makefile.def</samp>.
    457  1.10    mrg </p>
    458  1.19    mrg <p>Necessary to regenerate the <samp>bits/version.h</samp> header for libstdc++.
    459  1.19    mrg </p>
    460  1.10    mrg </dd>
    461  1.18    mrg <dt>Flex version 2.5.4 (or later)</dt>
    462  1.10    mrg <dd>
    463  1.10    mrg <p>Necessary when modifying <samp>*.l</samp> files.
    464  1.10    mrg </p>
    465  1.10    mrg <p>Necessary to build GCC during development because the generated output
    466  1.11    mrg files are not included in the version-controlled source repository.
    467  1.11    mrg They are included in releases.
    468  1.10    mrg </p>
    469  1.10    mrg </dd>
    470  1.18    mrg <dt>Texinfo version 4.7 (or later)</dt>
    471  1.10    mrg <dd>
    472  1.10    mrg <p>Necessary for running <code>makeinfo</code> when modifying <samp>*.texi</samp>
    473   1.1    mrg files to test your changes.
    474  1.10    mrg </p>
    475  1.19    mrg <p>Necessary for running <code>make dvi</code>, <code>make pdf</code>,
    476  1.19    mrg or <code>make html</code> to create formatted documentation.  Texinfo version
    477  1.10    mrg 4.8 or later is required for <code>make pdf</code>.
    478  1.10    mrg </p>
    479  1.19    mrg <p>Necessary to build GCC documentation in info format during development
    480  1.19    mrg because the generated output files are not included in the repository.
    481  1.19    mrg (They are included in release tarballs.)
    482  1.19    mrg </p>
    483  1.19    mrg <p>Note that the minimum requirement is for a very old version of
    484  1.19    mrg Texinfo, but recent versions of Texinfo produce better-quality output,
    485  1.19    mrg especially for HTML format.  The version of Texinfo packaged with any
    486  1.19    mrg current operating system distribution is likely to be adequate for
    487  1.19    mrg building the documentation without error, but you may still want to
    488  1.19    mrg install a newer release to get the best appearance and usability of
    489  1.19    mrg the generated manuals.
    490  1.10    mrg </p>
    491  1.10    mrg </dd>
    492  1.18    mrg <dt>TeX (any working version)</dt>
    493  1.10    mrg <dd>
    494  1.10    mrg <p>Necessary for running <code>texi2dvi</code> and <code>texi2pdf</code>, which
    495  1.10    mrg are used when running <code>make dvi</code> or <code>make pdf</code> to create
    496  1.10    mrg DVI or PDF files, respectively.
    497  1.10    mrg </p>
    498  1.10    mrg </dd>
    499  1.18    mrg <dt>Sphinx version 1.0 (or later)</dt>
    500  1.10    mrg <dd>
    501  1.10    mrg <p>Necessary to regenerate <samp>jit/docs/_build/texinfo</samp> from the <samp>.rst</samp>
    502  1.10    mrg files in the directories below <samp>jit/docs</samp>.
    503  1.10    mrg </p>
    504  1.10    mrg </dd>
    505  1.18    mrg <dt>git (any version)</dt>
    506  1.18    mrg <dt>SSH (any version)</dt>
    507  1.10    mrg <dd>
    508  1.11    mrg <p>Necessary to access the source repository.  Public releases and weekly
    509  1.11    mrg snapshots of the development sources are also available via HTTPS.
    510  1.10    mrg </p>
    511  1.10    mrg </dd>
    512  1.18    mrg <dt>GNU diffutils version 2.7 (or later)</dt>
    513  1.10    mrg <dd>
    514  1.10    mrg <p>Useful when submitting patches for the GCC source code.
    515  1.10    mrg </p>
    516  1.10    mrg </dd>
    517  1.18    mrg <dt>patch version 2.5.4 (or later)</dt>
    518  1.10    mrg <dd>
    519  1.10    mrg <p>Necessary when applying patches, created with <code>diff</code>, to one&rsquo;s
    520  1.10    mrg own sources.
    521  1.10    mrg </p>
    522  1.10    mrg </dd>
    523  1.10    mrg </dl>
    524  1.10    mrg 
    525  1.10    mrg <hr />
    526  1.10    mrg <p>
    527  1.10    mrg <p><a href="./index.html">Return to the GCC Installation page</a>
    528  1.10    mrg </p>
    529  1.10    mrg 
    530  1.10    mrg 
    531  1.10    mrg 
    532  1.10    mrg 
    533   1.9    mrg 
    534   1.7    mrg 
    535   1.7    mrg 
    536   1.7    mrg 
    537   1.7    mrg 
    538   1.7    mrg 
    539   1.6    mrg 
    540   1.1    mrg 
    541  1.10    mrg </body>
    542  1.10    mrg </html>
    543