[commit: ghc] ghc-7.10: docs: Flatten MAKEHELP/SUBMAKEHELP (b6fc8a9)

git at git.haskell.org git at git.haskell.org
Mon Feb 23 11:24:02 UTC 2015


Repository : ssh://git@git.haskell.org/ghc

On branch  : ghc-7.10
Link       : http://ghc.haskell.org/trac/ghc/changeset/b6fc8a97a306a984329a883bde09e11b5455f0aa/ghc

>---------------------------------------------------------------

commit b6fc8a97a306a984329a883bde09e11b5455f0aa
Author: Austin Seipp <austin at well-typed.com>
Date:   Mon Feb 23 05:21:11 2015 -0600

    docs: Flatten MAKEHELP/SUBMAKEHELP
    
    There's no reason to have two files, and this is one step towards a
    cleaner root directory.
    
    Signed-off-by: Austin Seipp <austin at well-typed.com>
    (cherry picked from commit c3f9eb4d0626fc40f77e61653deca84cc3e1542f)


>---------------------------------------------------------------

b6fc8a97a306a984329a883bde09e11b5455f0aa
 MAKEHELP    | 49 -------------------------------------
 MAKEHELP.md | 81 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 SUBMAKEHELP | 33 -------------------------
 ghc.mk      |  2 +-
 4 files changed, 82 insertions(+), 83 deletions(-)

diff --git a/MAKEHELP b/MAKEHELP
deleted file mode 100644
index ab42ddf..0000000
--- a/MAKEHELP
+++ /dev/null
@@ -1,49 +0,0 @@
-
-Using the GHC build system
---------------------------
-
-For a "Getting Started" guide, see:
-
-  http://ghc.haskell.org/trac/ghc/wiki/Building/Hacking
-
-Common commands:
-
-  make
-
-     Builds everything: ghc stages 1 and 2, all libraries and tools.
-
-  make -j2
-
-     Parallel build: runs up to 2 commands at a time (use the number of
-     CPUs in your machine in place of '2')
-
-  cd <dir>; make
-
-     Builds everything in the given directory.
-
-  cd <dir>; make help
-
-     Shows the targets available in <dir>
-
-  make install
-
-     Installs GHC, libraries and tools under $(prefix)
-
-  make sdist
-  make binary-dist
-
-     Builds a source or binary distribution respectively
-
-  make show VALUE=<var>
-
-     Displays the value of make variable <var>
-
-  make clean
-  make distclean
-  make maintainer-clean
-
-     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
-     completely clean checked-out state.
-
diff --git a/MAKEHELP.md b/MAKEHELP.md
new file mode 100644
index 0000000..ff0e434
--- /dev/null
+++ b/MAKEHELP.md
@@ -0,0 +1,81 @@
+Quick `make` guide for GHC
+==========================
+
+For a "Getting Started" guide, see:
+
+  http://ghc.haskell.org/trac/ghc/wiki/Building/Hacking
+
+Common commands:
+
+  - `make`
+
+    Builds everything: ghc stages 1 and 2, all libraries and tools.
+
+  - `make -j2`
+
+    Parallel build: runs up to 2 commands at a time.
+
+  - `cd <dir>; make`
+
+    Builds everything in the given directory.
+
+  - cd <dir>; make help
+
+    Shows the targets available in <dir>
+
+  - make install
+
+    Installs GHC, libraries and tools under $(prefix)
+
+  - make sdist
+  - make binary-dist
+
+    Builds a source or binary distribution respectively
+
+  - `make show VALUE=<var>`
+
+    Displays the value of make variable <var>
+
+  - make clean
+  - make distclean
+  - make maintainer-clean
+
+    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
+    completely clean checked-out state.
+
+Using `make` in subdirectories
+==============================
+
+  - `make`
+
+    Builds everything in this directory (including dependencies elsewhere
+    in the tree, if necessary)
+
+  - `make fast`
+
+    The same as 'make', but omits some phases and does not
+    recalculate dependencies.  Useful for saving time if you are sure
+    the rest of the tree is up to date.
+
+  - `make clean`
+  - `make distclean`
+  - `make maintainer-clean`
+
+    Clean just this directory
+
+  - `make html`
+  - `make pdf`
+  - `make ps`
+
+    Make documentation in this directory (if any)
+
+  - `make show VALUE=var`
+
+    Show the value of $(var)
+
+  - `make <file>`
+
+    Bring a particular file up to date, e.g. make dist/build/Module.o
+    The name <file> is relative to the current directory
diff --git a/SUBMAKEHELP b/SUBMAKEHELP
deleted file mode 100644
index e109d89..0000000
--- a/SUBMAKEHELP
+++ /dev/null
@@ -1,33 +0,0 @@
-
-  make
-
-     Builds everything in this directory (including dependencies elsewhere
-     in the tree, if necessary)
-
-  make fast
-
-     The same as 'make', but omits some phases and does not
-     recalculate dependencies.  Useful for saving time if you are sure
-     the rest of the tree is up to date.
-
-  make clean
-  make distclean
-  make maintainer-clean
-
-     Clean just this directory
-
-  make html
-  make pdf
-  make ps
-     
-     Make documentation in this directory (if any)
-
-  make show VALUE=var
-
-     Show the value of $(var)
-
-  make <file>
-
-     Bring a particular file up to date, e.g. make dist/build/Module.o
-     The name <file> is relative to the current directory
-
diff --git a/ghc.mk b/ghc.mk
index 08dcf19..aa29171 100644
--- a/ghc.mk
+++ b/ghc.mk
@@ -1110,7 +1110,7 @@ SRC_DIST_GHC_FILES += \
     configure.ac config.guess config.sub configure \
     aclocal.m4 README.md ANNOUNCE HACKING.md INSTALL.md LICENSE Makefile
     install-sh settings.in VERSION GIT_COMMIT_ID \
-    boot packages ghc.mk
+    boot packages ghc.mk MAKEHELP.md
 
 .PHONY: VERSION
 VERSION:



More information about the ghc-commits mailing list