testsuite: Add tests for #15270

[ghc.git] / MAKEHELP.md

diff --git a/MAKEHELP.md b/MAKEHELP.md
index 3b58292..819da97 100644 (file)
--- a/MAKEHELP.md
+++ b/MAKEHELP.md
@@ -3,7 +3,9 @@ Quick `make` guide for GHC
 
 For a "Getting Started" guide, see:
 
-  http://ghc.haskell.org/trac/ghc/wiki/Building/Hacking
+  https://ghc.haskell.org/trac/ghc/wiki/Building/QuickStart
+  https://ghc.haskell.org/trac/ghc/wiki/Building/Using
+  https://ghc.haskell.org/trac/ghc/wiki/Building/StandardTargets
 
 Common commands:
 
@@ -24,8 +26,10 @@ Common commands:
     Shows the targets available in <dir>
 
   - make install
+  - make install-strip
 
-    Installs GHC, libraries and tools under $(prefix)
+    Installs GHC, libraries and tools under $(prefix). The install-strip
+    variant strips executable files while installing them.
 
   - make sdist
   - make binary-dist
@@ -33,13 +37,10 @@ Common commands:
     Builds a source or binary distribution respectively
 
   - `make show VALUE=<var>`
-
-    Displays the value of make variable <var>
-
   - `make show! VALUE=<var>`
 
-    Same as `make show`, but works right after ./configure (it skips reading
-    package-data.mk files).
+    Show the value of make variable <var>. The show! variant works right after
+    ./configure (it skips reading package-data.mk files).
 
   - make clean
   - make distclean
@@ -47,7 +48,7 @@ Common commands:
 
     Various levels of cleaning: "clean" restores the tree to the
     state after "./configure", "distclean" restores to the state
-    after "perl boot", and maintainer-clean restores the tree to the
+    after "python3 boot", and maintainer-clean restores the tree to the
     completely clean checked-out state.
 
 Using `make` in subdirectories
@@ -76,9 +77,11 @@ Using `make` in subdirectories
 
     Make documentation in this directory (if any)
 
-  - `make show VALUE=var`
+  - `make show VALUE=<var>`
+  - `make show! VALUE=<var>`
 
-    Show the value of $(var)
+    Show the value of make variable <var>. The show! variant works right after
+    ./configure (it skips reading package-data.mk files).
 
   - `make <file>`