Changes between Version 9 and Version 10 of Building/Files


Ignore:
Timestamp:
Aug 17, 2008 1:25:55 PM (6 years ago)
Author:
igloo
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • Building/Files

    v9 v10  
    2626== `utils/`, `libffi/` == 
    2727 
    28 The `utils` directory contains support utilities that GHC uses.  Some of these are themselves separate repositories that `darcs-all` pulls; others are part of the main GHC repository.  Typically these utilities are built once and for all when your build tree is initialised. 
     28The `utils` directory contains support utilities that GHC uses.  Some of these are themselves separate repositories that `darcs-all` pulls; others are part of the main GHC repository. These utils may be built with the bootstrapping compiler, for use during the build, or with the stage1 compiler, for installing. Some of them are built with both; we can't install the utils built with the bootstrapping compiler as they may use different versions of C libraries. 
    2929 
    3030''Why isn't libffi in utils/?'' 
    3131 
    32 == `compiler/`, `rts/`, `docs/`, `includes/` ==  
     32== `compiler/`, `ghc/`, `rts/`, `docs/`, `includes/` ==  
    3333 
    3434These directories contain the main GHC compiler, runtime system, and documentation. 
     
    4141== Stuff that appears only in a build tree == 
    4242 
    43   '''`ghc/`''':: 
    44     This directory appears only in the build tree. It contains the `.hi` and `.o` files obtained by compiling the compiler. 
    4543    * '''`ghc/stage1-inplace/`, `ghc/stage2-inplace/`''' 
    46       Code for the stage1 and stage2 compiler. 
     44      The in-place installations of GHC, so you can use the compiler in a build tree. 
    4745 
    48 ''There seems to be `ghc/dist-stage1` too... what's that?  Also there is `compiler/stage1`! 
     46    * '''`compiler/stage1/`, `ghc/stage2plus/`''' 
     47      These directories contain `ghc_boot_platform.h`, which contains various `#define`s needed when building GHC. These are different depending on whether we are building stage1 or a later stage. 
     48 
     49    * '''`.../dist*/`''' 
     50      In many directories, `dist*` subdirectories appear. These are where Cabal puts all of the files generated while building.