INSTALL/build.html

   1 <html>
   2 <head>
   3 <title>Building egcs-1.00 </title>
   4 </head>
   5 <body bgcolor="white">
   6 <h1 align="center">Building egcs-1.00</h1>
   7
   8 <p>Now that egcs is configured, you are ready to build the compiler and
   9 runtime libraries.
  10
  11 <p>We <b>highly</b> recommend that egcs be built using gnu-make; other
  12 versions make work, then again they might not.  To be safe build with gnu-make.
  13 <p>
  14
  15 <b>Building a native compiler</b>
  16 <p>For a native build issue the command "make bootstrap".  This will build
  17 the entire egcs compiler system, which includes the following steps:
  18
  19 <ul>
  20   <li> Build host tools necessary to build the compiler such as texinfo, bison,
  21   gperf.<p>
  22
  23   <li> Build target tools for use by the compiler such as gas, gld, and
  24   binutils.<p>
  25
  26   <li> Perform a 3-stage bootstrap of the compiler.<p>
  27
  28   <li> Perform a comparison test of the stage2 and stage3 compilers.<p>
  29
  30   <li> Build runtime libraries using the stage3 compiler from the previous
  31   step.<p>
  32 </ul>
  33
  34 <p>If you are short on disk space you might consider "make bootstrap-lean"
  35 instead.  This is identical to "make bootstrap" except that object files
  36 from the stage1 and stage2 of the 3-stage bootstrap of the compiler are
  37 deleted as soon as they are no longer needed.
  38
  39 <b>Building a cross compiler</b>
  40
  41 <p> We recommend reading the
  42 <a href="ftp://ftp.cygnus.com/pub/embedded/crossgcc/FAQ-0.8.1">
  43 crossgcc FAQ</a> for information about building cross compilers.
  44
  45 <p>For a cross build, issue the command "make cross", which performs the
  46 following steps:
  47 <ul>
  48   <li> Build host tools necessary to build the compiler such as texinfo, bison,
  49   gperf.<p>
  50
  51   <li> Build target tools for use by the compiler such as gas, gld, and
  52   binutils.<p>
  53
  54   <li> Build the compiler (single stage only).<p>
  55
  56   <li> Build runtime libraries using the compiler from the previous
  57   step.<p>
  58 </ul>
  59
  60 <p>Note that if an error occurs in any step the make process will exit.
  61
  62 <p>
  63 <hr>
  64 <i>Last modified on December 1, 1997.</i>
  65
  66 </body>
  67 </html>