testsuite: Ensure T5423 flushes C output buffer
[ghc.git] / INSTALL.md
index 34bb5b4..88d433e 100644 (file)
@@ -8,17 +8,17 @@ has all the answers.
 Before building GHC you may need to install some other tools and
 libraries.  See "Setting up your system for building GHC" [2].
 
-NB. in particular you need GHC installed in order to build GHC,
+N.B. in particular you need GHC installed in order to build GHC,
 because the compiler is itself written in Haskell.  For instructions
 on how to port GHC to a new platform, see the Building Guide [1].
 
 For building library documentation, you'll need Haddock [3].  To build
 the compiler documentation, you need [Sphinx](http://www.sphinx-doc.org/) and
-Xelatex (only for PDF output).
+XeLaTex (only for PDF output).
 
 Quick start:  the following gives you a default build:
 
-    $ perl boot
+    $ ./boot
     $ ./configure
     $ make
     $ make install
@@ -28,9 +28,12 @@ Quick start:  the following gives you a default build:
 
     $ ./configure --enable-tarballs-autodownload
 
-The "perl boot" step is only necessary if this is a tree checked out
-from git.  For source distributions downloaded from GHC's web site,
-this step has already been performed.
+You can use Make's `-jN` option to parallelize the build. It's generally best
+to set `N` somewhere around the core count of the build machine.
+
+The `./boot` step is only necessary if this is a tree checked out from
+git. For source distributions downloaded from GHC's web site, this step has
+already been performed.
 
 These steps give you the default build, which includes everything
 optimised and built in various ways (eg. profiling libs are built).
@@ -40,6 +43,6 @@ It can take a long time.  To customise the build, see the file
 References
 ==========
 
- [1] http://www.haskell.org/ghc/
[2] http://hackage.haskell.org/trac/ghc/wiki/Building/Preparation
- [3] http://www.haskell.org/haddock/
[1] http://www.haskell.org/ghc/
- [2] https://gitlab.haskell.org/ghc/ghc/wikis/building/preparation
[3] http://www.haskell.org/haddock/