1#
2# FreeType build system -- top-level sub-Makefile
3#
4
5
6# Copyright 1996-2018 by
7# David Turner, Robert Wilhelm, and Werner Lemberg.
8#
9# This file is part of the FreeType project, and may only be used, modified,
10# and distributed under the terms of the FreeType project license,
11# LICENSE.TXT.  By continuing to use, modify, or distribute this file you
12# indicate that you have read the license and understand and accept it
13# fully.
14
15
16# This file is designed for GNU Make, do not use it with another Make tool!
17#
18# It works as follows:
19#
20# - When invoked for the first time, this Makefile includes the rules found
21#   in `PROJECT/builds/detect.mk'.  They are in charge of detecting the
22#   current platform.
23#
24#   A summary of the detection is displayed, and the file `config.mk' is
25#   created in the current directory.
26#
27# - When invoked later, this Makefile includes the rules found in
28#   `config.mk'.  This sub-Makefile defines some system-specific variables
29#   (like compiler, compilation flags, object suffix, etc.), then includes
30#   the rules found in `PROJECT/builds/PROJECT.mk', used to build the
31#   library.
32#
33# See the comments in `builds/detect.mk' and `builds/PROJECT.mk' for more
34# details on host platform detection and library builds.
35
36
37# First of all, check whether we have `$(value ...)'.  We do this by testing
38# for `$(eval ...)' which has been introduced in the same GNU make version.
39
40eval_available :=
41$(eval eval_available := T)
42ifneq ($(eval_available),T)
43  $(error FreeType's build system needs a Make program which supports $$(value))
44endif
45
46
47.PHONY: all dist distclean modules setup
48
49
50# The `space' variable is used to avoid trailing spaces in defining the
51# `T' variable later.
52#
53empty :=
54space := $(empty) $(empty)
55
56
57# The main configuration file, defining the `XXX_MODULES' variables.  We
58# prefer a `modules.cfg' file in OBJ_DIR over TOP_DIR.
59#
60ifndef MODULES_CFG
61  MODULES_CFG := $(TOP_DIR)/modules.cfg
62  ifneq ($(wildcard $(OBJ_DIR)/modules.cfg),)
63    MODULES_CFG := $(OBJ_DIR)/modules.cfg
64  endif
65endif
66
67
68# FTMODULE_H, as its name suggests, indicates where the FreeType module
69# class file resides.
70#
71FTMODULE_H ?= $(OBJ_DIR)/ftmodule.h
72
73
74include $(MODULES_CFG)
75
76
77# The list of modules we are using.
78#
79MODULES := $(FONT_MODULES)    \
80           $(HINTING_MODULES) \
81           $(RASTER_MODULES)  \
82           $(AUX_MODULES)
83
84
85CONFIG_MK ?= config.mk
86
87# If no configuration sub-makefile is present, or if `setup' is the target
88# to be built, run the auto-detection rules to figure out which
89# configuration rules file to use.
90#
91# Note that the configuration file is put in the current directory, which is
92# not necessarily $(TOP_DIR).
93
94# If `config.mk' is not present, set `check_platform'.
95#
96ifeq ($(wildcard $(CONFIG_MK)),)
97  check_platform := 1
98endif
99
100# If `setup' is one of the targets requested, set `check_platform'.
101#
102ifneq ($(findstring setup,$(MAKECMDGOALS)),)
103  check_platform := 1
104endif
105
106# Include the automatic host platform detection rules when we need to
107# check the platform.
108#
109ifdef check_platform
110
111  all modules: setup
112
113  include $(TOP_DIR)/builds/detect.mk
114
115  # This rule makes sense for Unix only to remove files created by a run of
116  # the configure script which hasn't been successful (so that no
117  # `config.mk' has been created).  It uses the built-in $(RM) command of
118  # GNU make.  Similarly, `nul' is created if e.g. `make setup windows' has
119  # been erroneously used.
120  #
121  # Note: This test is duplicated in `builds/unix/detect.mk'.
122  #
123  is_unix := $(strip $(wildcard /sbin/init) \
124                     $(wildcard /usr/sbin/init) \
125                     $(wildcard /dev/null) \
126                     $(wildcard /hurd/auth))
127  ifneq ($(is_unix),)
128
129    distclean:
130	  $(RM) builds/unix/config.cache
131	  $(RM) builds/unix/config.log
132	  $(RM) builds/unix/config.status
133	  $(RM) builds/unix/unix-def.mk
134	  $(RM) builds/unix/unix-cc.mk
135	  $(RM) builds/unix/freetype2.pc
136	  $(RM) nul
137
138  endif # test is_unix
139
140  # IMPORTANT:
141  #
142  # `setup' must be defined by the host platform detection rules to create
143  # the `config.mk' file in the current directory.
144
145else
146
147  # A configuration sub-Makefile is present -- simply run it.
148  #
149  all: single
150
151  BUILD_PROJECT := yes
152  include $(CONFIG_MK)
153
154endif # test check_platform
155
156
157# We always need the list of modules in ftmodule.h.
158#
159all setup: $(FTMODULE_H)
160
161
162# The `modules' target unconditionally rebuilds the module list.
163#
164modules:
165	$(FTMODULE_H_INIT)
166	$(FTMODULE_H_CREATE)
167	$(FTMODULE_H_DONE)
168
169include $(TOP_DIR)/builds/modules.mk
170
171
172# get FreeType version string, using a
173# poor man's `sed' emulation with make's built-in string functions
174#
175work := $(strip $(shell $(CAT) \
176                  $(subst /,$(SEP),$(TOP_DIR)/include/freetype/freetype.h)))
177work := $(subst |,x,$(work))
178work := $(subst $(space),|,$(work))
179work := $(subst \#define|FREETYPE_MAJOR|,$(space),$(work))
180work := $(word 2,$(work))
181major := $(subst |,$(space),$(work))
182major := $(firstword $(major))
183
184work := $(subst \#define|FREETYPE_MINOR|,$(space),$(work))
185work := $(word 2,$(work))
186minor := $(subst |,$(space),$(work))
187minor := $(firstword $(minor))
188
189work := $(subst \#define|FREETYPE_PATCH|,$(space),$(work))
190work := $(word 2,$(work))
191patch := $(subst |,$(space),$(work))
192patch := $(firstword $(patch))
193
194ifneq ($(findstring x0x,x$(patch)x),)
195  version := $(major).$(minor)
196  winversion := $(major)$(minor)
197else
198  version := $(major).$(minor).$(patch)
199  winversion := $(major)$(minor)$(patch)
200endif
201
202
203# This target builds the tarballs.
204#
205# Not to be run by a normal user -- there are no attempts to make it
206# generic.
207
208dist:
209	-rm -rf tmp
210	rm -f freetype-$(version).tar.gz
211	rm -f freetype-$(version).tar.bz2
212	rm -f ft$(winversion).zip
213
214	for d in `find . -wholename '*/.git' -prune \
215	                 -o -type f \
216	                 -o -print` ; do \
217	  mkdir -p tmp/$$d ; \
218	done ;
219
220	currdir=`pwd` ; \
221	for f in `find . -wholename '*/.git' -prune \
222	                 -o -name .gitignore \
223	                 -o -name .mailmap \
224	                 -o -type d \
225	                 -o -print` ; do \
226	  ln -s $$currdir/$$f tmp/$$f ; \
227	done
228
229	@# Prevent generation of .pyc files.  Python follows (soft) links if
230	@# the link's directory is write protected, so we have temporarily
231	@# disable write access here too.
232	chmod -w src/tools/docmaker
233
234	cd tmp ; \
235	$(MAKE) devel ; \
236	$(MAKE) do-dist
237
238	chmod +w src/tools/docmaker
239
240	mv tmp freetype-$(version)
241
242	tar -H ustar -chf - freetype-$(version) \
243	| gzip -9 -c > freetype-$(version).tar.gz
244	tar -H ustar -chf - freetype-$(version) \
245	| bzip2 -c > freetype-$(version).tar.bz2
246
247	@# Use CR/LF for zip files.
248	zip -lr9 ft$(winversion).zip freetype-$(version)
249
250	rm -fr freetype-$(version)
251
252
253# The locations of the latest `config.guess' and `config.sub' versions (from
254# GNU `config' git repository), relative to the `tmp' directory used during
255# `make dist'.
256#
257CONFIG_GUESS = ~/git/config/config.guess
258CONFIG_SUB   = ~/git/config/config.sub
259
260
261# Don't say `make do-dist'.  Always use `make dist' instead.
262#
263.PHONY: do-dist
264
265do-dist: distclean refdoc
266	@# Without removing the files, `autoconf' and friends follow links.
267	rm -f builds/unix/aclocal.m4
268	rm -f builds/unix/configure.ac
269	rm -f builds/unix/configure
270
271	sh autogen.sh
272	rm -rf builds/unix/autom4te.cache
273
274	cp $(CONFIG_GUESS) builds/unix
275	cp $(CONFIG_SUB) builds/unix
276
277# EOF
278