INSTALL/build.html

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