[commit: ghc] wip/nfs-locking: Update notes on build ways and flavours (3d4e548)

git at git.haskell.org git at git.haskell.org
Fri Oct 27 01:16:49 UTC 2017


Repository : ssh://git@git.haskell.org/ghc

On branch  : wip/nfs-locking
Link       : http://ghc.haskell.org/trac/ghc/changeset/3d4e54873fceedee20c3e0c0fbb56598030252a9/ghc

>---------------------------------------------------------------

commit 3d4e54873fceedee20c3e0c0fbb56598030252a9
Author: Andrey Mokhov <andrey.mokhov at gmail.com>
Date:   Thu Jan 12 01:15:19 2017 +0000

    Update notes on build ways and flavours
    
    [skip ci]


>---------------------------------------------------------------

3d4e54873fceedee20c3e0c0fbb56598030252a9
 README.md | 16 +++++++++-------
 1 file changed, 9 insertions(+), 7 deletions(-)

diff --git a/README.md b/README.md
index 0d7b3d8..109f7f0 100644
--- a/README.md
+++ b/README.md
@@ -6,7 +6,7 @@ Hadrian
 Hadrian is a new build system for the [Glasgow Haskell Compiler][ghc]. It is based
 on [Shake][shake] and we hope that it will eventually replace the current
 [`make`-based build system][make]. If you are curious about the rationale behind the
-project and the architecture of the new build system you can find more details in
+project and the architecture of the build system you can find more details in
 this [Haskell Symposium 2016 paper][paper] and this [Haskell eXchange 2016 talk][talk].
 
 The new build system can work side-by-side with the existing build system. Note, there is
@@ -52,9 +52,11 @@ are placed into `_build` and `inplace` directories.
 
 In addition to standard Shake flags (try `--help`), the build system
 currently supports several others:
-* `--flavour=FLAVOUR`: choose a build flavour. Two settings are currently supported:
-`default` and `quick` (adds `-O0` flag to all GHC invocations and disables library
-profiling, which speeds up builds by 3-4x).
+* `--flavour=FLAVOUR`: choose a build flavour. The following settings are currently supported:
+`default`, `quick`, `quickest`, `perf`, `prof`, `devel1` and `devel2`. As an example, the
+`quickest` flavour adds `-O0` flag to all GHC invocations and builds libraries only in the
+`vanilla` way, which speeds up builds by 3-4x. Build flavours are documented
+[here](https://github.com/snowleopard/hadrian/blob/master/doc/flavours.md).
 
 * `--haddock`: build Haddock documentation.
 
@@ -117,10 +119,10 @@ zero (see [#197][test-issue]).
 Current limitations
 -------------------
 The new build system still lacks many important features:
-* We only build `vanilla` and `profiling` way: [#4][dynamic-issue].
+* There is currently no support for the `dynamic` build way: [#4][dynamic-issue].
 * Validation is not implemented: [#187][validation-issue].
 * Only HTML Haddock documentation is supported (use `--haddock` flag). 
-* Build flavours and conventional command line flags are not implemented: [#188][flavours-issue].
+* Not all modes of the old build system are supported, e.g. [#250][freeze-issue].
 * Cross-compilation is not implemented: [#177][cross-compilation-issue].
 * There is no support for installation or binary distribution: [#219][install-issue].
 
@@ -159,7 +161,7 @@ helped me endure and enjoy the project.
 [test-issue]: https://github.com/snowleopard/hadrian/issues/197
 [dynamic-issue]: https://github.com/snowleopard/hadrian/issues/4
 [validation-issue]: https://github.com/snowleopard/hadrian/issues/187
-[flavours-issue]: https://github.com/snowleopard/hadrian/issues/188
+[freeze-issue]: https://github.com/snowleopard/hadrian/issues/250
 [cross-compilation-issue]: https://github.com/snowleopard/hadrian/issues/177
 [install-issue]: https://github.com/snowleopard/hadrian/issues/219
 [milestones]: https://github.com/snowleopard/hadrian/milestones



More information about the ghc-commits mailing list