Add an install-docs target that emits a helpful diagnostic (#3662)
[ghc.git] / Makefile
1 # -----------------------------------------------------------------------------
2 #
3 # (c) 2009 The University of Glasgow
4 #
5 # This file is part of the GHC build system.
6 #
7 # To understand how the build system works and how to modify it, see
8 # http://hackage.haskell.org/trac/ghc/wiki/Building/Architecture
9 # http://hackage.haskell.org/trac/ghc/wiki/Building/Modifying
10 #
11 # -----------------------------------------------------------------------------
12
13 ifeq "$(wildcard distrib/)" ""
14
15 # We're in a bindist
16
17 .PHONY: default
18 default:
19 @echo 'Run "make install" to install'
20 @false
21
22 .PHONY: install show
23 install show:
24 $(MAKE) -r --no-print-directory -f ghc.mk $@ BINDIST=YES NO_INCLUDE_DEPS=YES
25
26 else
27
28 default : all
29 @:
30
31 # For help, type 'make help'
32 .PHONY: help
33 help :
34 @cat MAKEHELP
35
36 ifneq "$(findstring clean,$(MAKECMDGOALS))" ""
37 -include mk/config.mk
38 else
39 include mk/config.mk
40 ifeq "$(ProjectVersion)" ""
41 $(error Please run ./configure first)
42 endif
43 endif
44
45 include mk/custom-settings.mk
46
47 # No need to update makefiles for these targets:
48 REALGOALS=$(filter-out binary-dist binary-dist-prep bootstrapping-files framework-pkg clean clean_% distclean maintainer-clean show help install-docs,$(MAKECMDGOALS))
49
50 # configure touches certain files even if they haven't changed. This
51 # can mean a lot of unnecessary recompilation after a re-configure, so
52 # here we cache the old versions of these files so we can restore the
53 # timestamps.
54 %.old: %
55 @set -x && test -f $@ && cmp -s $< $@ || cp -p $< $@
56 touch -r $@ $<
57
58
59 # NB. not the same as saying '%: ...', which doesn't do the right thing:
60 # it does nothing if we specify a target that already exists.
61 .PHONY: $(REALGOALS)
62 $(REALGOALS) all: mk/config.mk.old mk/project.mk.old compiler/ghc.cabal.old
63 @echo "===--- updating makefiles phase 0"
64 $(MAKE) -r --no-print-directory -f ghc.mk phase=0 just-makefiles
65 ifneq "$(OMIT_PHASE_1)" "YES"
66 @echo "===--- updating makefiles phase 1"
67 $(MAKE) -r --no-print-directory -f ghc.mk phase=1 just-makefiles
68 endif
69 ifneq "$(OMIT_PHASE_2)" "YES"
70 @echo "===--- updating makefiles phase 2"
71 $(MAKE) -r --no-print-directory -f ghc.mk phase=2 just-makefiles
72 endif
73 ifneq "$(OMIT_PHASE_3)" "YES"
74 @echo "===--- updating makefiles phase 3"
75 $(MAKE) -r --no-print-directory -f ghc.mk phase=3 just-makefiles
76 endif
77 @echo "===--- finished updating makefiles"
78 $(MAKE) -r --no-print-directory -f ghc.mk $@
79
80 binary-dist: binary-dist-prep
81 ifeq "$(mingw32_TARGET_OS)" "1"
82 mv bindistprep/*.exe .
83 endif
84 mv bindistprep/*.tar.bz2 .
85
86 binary-dist-prep:
87 ifeq "$(mingw32_TARGET_OS)" "1"
88 $(MAKE) -r --no-print-directory -f ghc.mk windows-binary-dist-prep
89 $(MAKE) -r --no-print-directory -f ghc.mk windows-installer
90 else
91 rm -f bindist-list
92 $(MAKE) -r --no-print-directory -f ghc.mk bindist BINDIST=YES
93 $(MAKE) -r --no-print-directory -f ghc.mk unix-binary-dist-prep
94 endif
95
96 clean distclean maintainer-clean:
97 $(MAKE) -r --no-print-directory -f ghc.mk $@ CLEANING=YES
98 test ! -d testsuite || $(MAKE) -C testsuite $@
99
100 $(filter clean_%, $(MAKECMDGOALS)) : clean_% :
101 $(MAKE) -r --no-print-directory -f ghc.mk $@ CLEANING=YES
102
103 bootstrapping-files show:
104 $(MAKE) -r --no-print-directory -f ghc.mk $@
105
106 ifeq "$(darwin_TARGET_OS)" "1"
107 framework-pkg:
108 $(MAKE) -C distrib/MacOS $@
109 endif
110
111 # install-docs is a historical target that isn't supported in GHC 6.12. See #3662.
112 install-docs:
113 @echo "The install-docs target is not supported in GHC 6.12.1 and later."
114 @echo "'make install' now installs everything, including documentation."
115 @exit 1
116
117 # If the user says 'make A B', then we don't want to invoke two
118 # instances of the rule above in parallel:
119 .NOTPARALLEL:
120
121 endif