Fixed error messages for RecursiveDo (#8501)
[ghc.git] / INSTALL.md
index 58930af..3ae9186 100644 (file)
@@ -8,13 +8,13 @@ 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 a good DocBook XML toolchain and
-dblatex.
+the compiler documentation, you need [Sphinx](http://www.sphinx-doc.org/) and
+XeLaTex (only for PDF output).
 
 Quick start:  the following gives you a default build:
 
@@ -28,7 +28,10 @@ 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
+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 `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.