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