Changes between Version 4 and Version 5 of Building/GettingTheSources


Ignore:
Timestamp:
Oct 18, 2006 9:19:20 AM (9 years ago)
Author:
simonmar
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • Building/GettingTheSources

    v4 v5  
    5252}}}
    5353
    54 == List of repositories ==
     54The full list of darcs repositories relating to GHC is at DarcsRepositories.
    5555
    56 These darcs repositories are related to GHC:
     56=== Getting a branch ===
    5757
    58 ||[http://darcs.haskell.org/ghc]||The main GHC repository||
    59 ||[http://darcs.haskell.org/testsuite]||The test suite (requires python 2.4+) ||
    60 ||[http://darcs.haskell.org/nofib]||The benchmark suite||
     58The above instructions will get the HEAD - the main trunk of GHC development.  There are also branches, from which stable releases are made.  The active branches are listed on DarcsRepositories.
    6159
    62 The following repositories are the "core" packages, that populate the libraries directory of a GHC tree:
     60To get a branch, add the branch name after http://darcs.haskell.org/.  For example, to get the `ghc-6.6` branch, you would fist say
    6361
    64 ||http://darcs.haskell.org/packages/base||
    65 ||http://darcs.haskell.org/packages/Cabal||
    66 ||http://darcs.haskell.org/packages/haskell98||
    67 ||http://darcs.haskell.org/packages/readline||
    68 ||http://darcs.haskell.org/packages/regex-base||
    69 ||http://darcs.haskell.org/packages/regex-posix||
    70 ||http://darcs.haskell.org/packages/regex-compat||
    71 ||http://darcs.haskell.org/packages/stm||
    72 ||http://darcs.haskell.org/packages/template-haskell||
    73 ||http://darcs.haskell.org/packages/unix||
    74 ||http://darcs.haskell.org/packages/Win32||
     62{{{
     63  $ darcs get --partial http://darcs.haskell.org/ghc-6.6/ghc
     64}}}
    7565
    76 And the following repositories are the "extra" packages:
     66and then use `darcs-all` as above to get the rest of the respositories.
    7767
    78 ||http://darcs.haskell.org/packages/ALUT||
    79 ||http://darcs.haskell.org/packages/GLUT||
    80 ||http://darcs.haskell.org/packages/HGL||
    81 ||http://darcs.haskell.org/packages/HUnit||
    82 ||http://darcs.haskell.org/packages/HaXml||
    83 ||http://darcs.haskell.org/packages/Japi||
    84 ||http://darcs.haskell.org/packages/ObjectIO||
    85 ||http://darcs.haskell.org/packages/OpenAL||
    86 ||http://darcs.haskell.org/packages/OpenGL||
    87 ||http://darcs.haskell.org/packages/QuickCheck||
    88 ||http://darcs.haskell.org/packages/X11||
    89 ||http://darcs.haskell.org/packages/arrows||
    90 ||http://darcs.haskell.org/packages/fgl||
    91 ||http://darcs.haskell.org/packages/haskell-src||
    92 ||http://darcs.haskell.org/packages/html||
    93 ||http://darcs.haskell.org/packages/monads||
    94 ||http://darcs.haskell.org/packages/mtl||
    95 ||http://darcs.haskell.org/packages/network||
    96 ||http://darcs.haskell.org/packages/parsec||
    97 ||http://darcs.haskell.org/packages/time||
    98 ||http://darcs.haskell.org/packages/xhtml||
     68To get testsuite and/or nofib, you'll need to name the branch repositories:
     69
     70{{{
     71  $ darcs get --partial http://darcs.haskell.org/ghc-6.6/testsuite
     72  $ darcs get --partial http://darcs.haskell.org/ghc-6.6/nofib
     73}}}
    9974
    10075=== Pulling new patches ===
     
    10681}}}
    10782
    108 === Submitting patches ===
    109 
    110 To submit patches to the developers, please use {{{darcs send}}}.  You don't need any special permission to do this.
    111 
    112 === Committing changes ===
    113 
    114 If you have commit permission (pretty easy to get, just demonstrate your competence by sending us a patch or two first), then you can use {{{darcs push}}} to commit changes directly to the main repository.
     83Note that after pulling new changes, the safest way to continue working is to clean the build tree and start from scratch:
    11584
    11685{{{
    117   $ darcs push <account>@darcs.haskell.org:/home/darcs/ghc
     86  $ make distclean
     87  $ autoreconf
     88  $ ./configure
     89  $ make
    11890}}}
    11991
    120 (change {{{ghc}}} to the name of the repository if you're pushing changes from one of the sub-repositories, like {{{testsuite}}}, or a package such as {{{base}}}.  Note: {{{darcs push}}} requires that SSH is working and can log in to your account on {{{darcs.haskell.org}}}.
    121 
    122 Do not forget to {{{darcs record}}} your changes first!
    123 
    124 Please test changes before committing: you can run a cut-down version of the full test suite like this:
    125 
    126 {{{
    127   $ cd testsuite
    128   $ make boot
    129   $ cd tests/ghc-regress
    130   $ make fast
    131 }}}
    132 
    133 You need to have {{{testsuite}}} checked out, of course.  Running {{{make fast}}} should only take a few minutes.
    134 
    135 == The 6.6 branch ==
    136 
    137 There is a branch, for the 6.6 series of GHC releases, of the repositories for
    138 ghc, testsuite, nofib and the core libraries in the
    139 ||http://darcs.haskell.org/ghc-6.6||
    140 subtree.
    141 
    142 To use this branch instead of the HEAD, replace the first command in the instructions above with
    143 {{{
    144   $ darcs get --partial http://darcs.haskell.org/ghc-6.6/ghc
    145 }}}
    146 and use
    147 {{{
    148   $ darcs get --partial http://darcs.haskell.org/ghc-6.6/testsuite
    149   $ darcs get --partial http://darcs.haskell.org/ghc-6.6/nofib
    150 }}}
    151 to get the testsuite and nofib. Otherwise, the commands needed are identical to those for
    152 working with the HEAD.
     92You may be able to shortcut this procedure if you know what you're doing, or you could just take a risk and if anything goes wrong fall back to the above procedure.