doc/gf-developers.t2t: add a note about parallel builds

Also added a note that partial builds (cabal build rgl-none, etc) doesn't work
with newer versions of cabal.
This commit is contained in:
hallgren
2015-06-23 10:20:04 +00:00
parent e340b415c7
commit 72237e6fff

View File

@@ -4,7 +4,7 @@ Last update: %%mtime(%F, %H:%M)
% NOTE: this is a txt2tags file. % NOTE: this is a txt2tags file.
% Create an html file from this file using: % Create an html file from this file using:
% txt2tags -t html --toc darcs.txt % txt2tags -t html gf-developers.t2t
%!style:../css/style.css %!style:../css/style.css
%!target:html %!target:html
@@ -285,6 +285,27 @@ $ cabal build
Again you can add the option ``-v`` if you want to see more details. Again you can add the option ``-v`` if you want to see more details.
==== Parallel builds ====
If you have Cabal>=1.20 you can enable parallel compilation by using
```
$ cabal build -j
```
or by putting a line ``jobs: $ncpus`` in your ``.cabal/config`` file. Cabal
will pass this option to GHC when building the GF compiler, but only if you
have GHC>=7.8. Cabal can also pass this option to GF when compiling the
Resource Grammar Library, but the code is commented out by default to avoid
causing problems for developers with Cabal<1.20, so you have to manually
enable it by editing the last few lines in ``WebSetup.hs``.
==== Partial builds ====
**NOTE**: The following doesn't work with recent versions of ``cabal``.
%% // TH 2015-06-22
Sometimes you just want to work on the GF compiler and don't want to Sometimes you just want to work on the GF compiler and don't want to
recompile the resource library after each change. In this case use recompile the resource library after each change. In this case use
this extended command: this extended command: