Changes between Version 1 and Version 2 of Building/Files


Ignore:
Timestamp:
Aug 1, 2008 8:04:28 AM (7 years ago)
Author:
simonpj
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • Building/Files

    v1 v2  
    22 
    33Everything starts with the main GHC repository (see [wiki:Building/GettingTheSources]).   The buld system calls that directory `$(TOP)`.  All the paths below are relative to `$(TOP)`. 
     4 
     5== Files in `$(TOP)` == 
    46 
    57 '''`darcs-all`''':: 
     
    911  Lists the packages that `darcs-all` should get or pull.  `packages` is looked at only by `darcs-all`. 
    1012 
    11  '''`libraries/`''':: 
    12   Sub-directory for all the packages that GHC needs. 
     13 '''`ghc.spec`''':: 
     14  What is this? 
    1315 
    14  '''`utils/`''':: 
    15   Sub-directory for 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. 
     16== `libraries/` == 
    1617 
    17  '''`compiler/`''':: 
    18   The main GHC compiler. 
     18The `libraries/` directory contains all the packages that GHC needs to build. 
    1919 
    20  '''`rts/`''':: 
    21   The runtime system. 
     20== `utils/` == 
    2221 
    23  '''`mk/`''':: 
    24   Makefile support for the build system. 
     22The `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. 
    2523 
    26  '''`ghc/`''':: 
    27   This directory appears only in the build tree. It contains the `.hi` and `.o` files obtained by compiling the compiler. 
     24== `compiler/`, `rts/`, `docs/`, `includes/` ==  
     25 
     26These directories contain the main GHC compiler, runtime system, and documentation. 
     27 
     28== `testsuite/`, `nofib/` ==  
     29 
     30The `testsuite/` and `nofib/` directories contain apparatus for testing GHC.  Each is a separate repository, which can be gotten with `darcs-all`. 
     31 
     32== Stuff that appears only in a build tree == 
     33 
     34  '''`ghc/`''':: 
     35    This directory appears only in the build tree. It contains the `.hi` and `.o` files obtained by compiling the compiler. 
    2836    * '''`ghc/stage1-inplace/`, `ghc/stage2-inplace/`''' 
    2937      Code for the stage1 and stage2 compiler.