Changes between Version 4 and Version 5 of Building/GettingTheSources


Ignore:
Timestamp:
Oct 18, 2006 9:19:20 AM (8 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.