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.