Clone relevant constraints to avoid side-effects on HoleDests. Fixes #15370.
[ghc.git] / INSTALL.md
index 58930af..42bbc1e 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 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:
 
-    $ perl boot
+    $ python3 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 `python3 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).