Various egcs-1.0.1 related changes.
[official-gcc.git] / INSTALL / BUILD
blob05e0902052ed7980f601f895032207a44e816546
2                             Building egcs-1.0.1
3                                       
4    Now that egcs is configured, you are ready to build the compiler and
5    runtime libraries.
6    
7    We highly recommend that egcs be built using gnu-make; other versions
8    make work, then again they might not. To be safe build with gnu-make.
9    
10    Building a native compiler
11    
12    For a native build issue the command "make bootstrap". This will build
13    the entire egcs compiler system, which includes the following steps:
14      * Build host tools necessary to build the compiler such as texinfo,
15        bison, gperf.
16      * Build target tools for use by the compiler such as gas, gld, and
17        binutils.
18      * Perform a 3-stage bootstrap of the compiler.
19      * Perform a comparison test of the stage2 and stage3 compilers.
20      * Build runtime libraries using the stage3 compiler from the
21        previous step.
22        
23    If you are short on disk space you might consider "make
24    bootstrap-lean" instead. This is identical to "make bootstrap" except
25    that object files from the stage1 and stage2 of the 3-stage bootstrap
26    of the compiler are deleted as soon as they are no longer needed.
27    
28    Building a cross compiler
29    
30    We recommend reading the [1]crossgcc FAQ for information about
31    building cross compilers.
32    
33    For a cross build, issue the command "make cross", which performs the
34    following steps:
35      * Build host tools necessary to build the compiler such as texinfo,
36        bison, gperf.
37      * Build target tools for use by the compiler such as gas, gld, and
38        binutils.
39      * Build the compiler (single stage only).
40      * Build runtime libraries using the compiler from the previous step.
41        
42    Note that if an error occurs in any step the make process will exit.
43    
44      _________________________________________________________________
45                                       
46    Last modified on Jan 2, 1998.
48 References
50    1. ftp://ftp.cygnus.com/pub/embedded/crossgcc/FAQ-0.8.1