|
1 # |
|
2 # FreeType 2 library sub-Makefile |
|
3 # |
|
4 |
|
5 |
|
6 # Copyright 1996-2006, 2008, 2013, 2014 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 # DO NOT INVOKE THIS MAKEFILE DIRECTLY! IT IS MEANT TO BE INCLUDED BY |
|
17 # OTHER MAKEFILES. |
|
18 |
|
19 |
|
20 # The following variables (set by other Makefile components, in the |
|
21 # environment, or on the command line) are used: |
|
22 # |
|
23 # BUILD_DIR The architecture dependent directory, |
|
24 # e.g. `$(TOP_DIR)/builds/unix'. Added to INCLUDES also. |
|
25 # |
|
26 # OBJ_DIR The directory in which object files are created. |
|
27 # |
|
28 # LIB_DIR The directory in which the library is created. |
|
29 # |
|
30 # DOC_DIR The directory in which the API reference is created. |
|
31 # |
|
32 # INCLUDES A list of directories to be included additionally. |
|
33 # |
|
34 # DEVEL_DIR Development directory which is added to the INCLUDES |
|
35 # variable before the standard include directories. |
|
36 # |
|
37 # CFLAGS Compilation flags. This overrides the default settings |
|
38 # in the platform-specific configuration files. |
|
39 # |
|
40 # FTSYS_SRC If set, its value is used as the name of a replacement |
|
41 # file for `src/base/ftsystem.c'. |
|
42 # |
|
43 # FTDEBUG_SRC If set, its value is used as the name of a replacement |
|
44 # file for `src/base/ftdebug.c'. [For a normal build, this |
|
45 # file does nothing.] |
|
46 # |
|
47 # FTMODULE_H The file which contains the list of module classes for |
|
48 # the current build. Usually, this is automatically |
|
49 # created by `modules.mk'. |
|
50 # |
|
51 # BASE_OBJ_S |
|
52 # BASE_OBJ_M A list of base objects (for single object and multiple |
|
53 # object builds, respectively). Set up in |
|
54 # `src/base/rules.mk'. |
|
55 # |
|
56 # BASE_EXT_OBJ A list of base extension objects. Set up in |
|
57 # `src/base/rules.mk'. |
|
58 # |
|
59 # DRV_OBJ_S |
|
60 # DRV_OBJ_M A list of driver objects (for single object and multiple |
|
61 # object builds, respectively). Set up cumulatively in |
|
62 # `src/<driver>/rules.mk'. |
|
63 # |
|
64 # CLEAN |
|
65 # DISTCLEAN The sub-makefiles can append additional stuff to these two |
|
66 # variables which is to be removed for the `clean' resp. |
|
67 # `distclean' target. |
|
68 # |
|
69 # TOP_DIR, SEP, |
|
70 # COMPILER_SEP, |
|
71 # LIBRARY, CC, |
|
72 # A, I, O, T Check `config.mk' for details. |
|
73 |
|
74 |
|
75 # The targets `objects' and `library' are defined at the end of this |
|
76 # Makefile after all other rules have been included. |
|
77 # |
|
78 .PHONY: single multi objects library refdoc |
|
79 |
|
80 # default target -- build single objects and library |
|
81 # |
|
82 single: objects library |
|
83 |
|
84 # `multi' target -- build multiple objects and library |
|
85 # |
|
86 multi: objects library |
|
87 |
|
88 |
|
89 # The FreeType source directory, usually `./src'. |
|
90 # |
|
91 SRC_DIR := $(TOP_DIR)/src |
|
92 |
|
93 # The directory where the base layer components are placed, usually |
|
94 # `./src/base'. |
|
95 # |
|
96 BASE_DIR := $(SRC_DIR)/base |
|
97 |
|
98 # Other derived directories. |
|
99 # |
|
100 PUBLIC_DIR := $(TOP_DIR)/include |
|
101 INTERNAL_DIR := $(PUBLIC_DIR)/internal |
|
102 SERVICES_DIR := $(INTERNAL_DIR)/services |
|
103 CONFIG_DIR := $(PUBLIC_DIR)/config |
|
104 |
|
105 # The documentation directory. |
|
106 # |
|
107 DOC_DIR ?= $(TOP_DIR)/docs/reference |
|
108 |
|
109 # The final name of the library file. |
|
110 # |
|
111 PROJECT_LIBRARY := $(LIB_DIR)/$(LIBRARY).$A |
|
112 |
|
113 |
|
114 # include paths |
|
115 # |
|
116 # IMPORTANT NOTE: The architecture-dependent directory must ALWAYS be placed |
|
117 # before the standard include list. Porters are then able to |
|
118 # put their own version of some of the FreeType components |
|
119 # in the `builds/<system>' directory, as these files will |
|
120 # override the default sources. |
|
121 # |
|
122 INCLUDES := $(subst /,$(COMPILER_SEP),$(OBJ_DIR) \ |
|
123 $(DEVEL_DIR) \ |
|
124 $(BUILD_DIR) \ |
|
125 $(TOP_DIR)/include) |
|
126 |
|
127 INCLUDE_FLAGS := $(INCLUDES:%=$I%) |
|
128 |
|
129 ifdef DEVEL_DIR |
|
130 # We assume that all library dependencies for FreeType are fulfilled for a |
|
131 # development build, so we directly access the necessary include directory |
|
132 # information using `pkg-config'. |
|
133 INCLUDE_FLAGS += $(shell pkg-config --cflags libpng \ |
|
134 harfbuzz ) |
|
135 endif |
|
136 |
|
137 |
|
138 # C flags used for the compilation of an object file. This must include at |
|
139 # least the paths for the `base' and `builds/<system>' directories; |
|
140 # debug/optimization/warning flags + ansi compliance if needed. |
|
141 # |
|
142 # $(INCLUDE_FLAGS) should come before $(CFLAGS) to avoid problems with |
|
143 # old FreeType versions. |
|
144 # |
|
145 # Note what we also define the macro FT2_BUILD_LIBRARY when building |
|
146 # FreeType. This is required to let our sources include the internal |
|
147 # headers (something forbidden by clients). |
|
148 # |
|
149 # Finally, we define FT_CONFIG_MODULES_H so that the compiler uses the |
|
150 # generated version of `ftmodule.h' in $(OBJ_DIR). If there is an |
|
151 # `ftoption.h' files in $(OBJ_DIR), define FT_CONFIG_OPTIONS_H too. |
|
152 # |
|
153 ifneq ($(wildcard $(OBJ_DIR)/ftoption.h),) |
|
154 FTOPTION_H := $(OBJ_DIR)/ftoption.h |
|
155 FTOPTION_FLAG := $DFT_CONFIG_OPTIONS_H="<ftoption.h>" |
|
156 endif |
|
157 |
|
158 # Note that a build with the `configure' script uses $(CFLAGS) only. |
|
159 # |
|
160 FT_CFLAGS = $(CPPFLAGS) \ |
|
161 $(INCLUDE_FLAGS) \ |
|
162 $(CFLAGS) \ |
|
163 $DFT2_BUILD_LIBRARY \ |
|
164 $DFT_CONFIG_MODULES_H="<ftmodule.h>" \ |
|
165 $(FTOPTION_FLAG) |
|
166 FT_COMPILE = $(CC) $(ANSIFLAGS) $(FT_CFLAGS) |
|
167 |
|
168 |
|
169 # Include the `exports' rules file. |
|
170 # |
|
171 include $(TOP_DIR)/builds/exports.mk |
|
172 |
|
173 |
|
174 # Initialize the list of objects. |
|
175 # |
|
176 OBJECTS_LIST := |
|
177 |
|
178 |
|
179 # Define $(PUBLIC_H) as the list of all public header files located in |
|
180 # `$(TOP_DIR)/include/freetype'. $(INTERNAL_H), and $(CONFIG_H) are defined |
|
181 # similarly. |
|
182 # |
|
183 # This is used to simplify the dependency rules -- if one of these files |
|
184 # changes, the whole library is recompiled. |
|
185 # |
|
186 PUBLIC_H := $(wildcard $(PUBLIC_DIR)/*.h) |
|
187 INTERNAL_H := $(wildcard $(INTERNAL_DIR)/*.h) \ |
|
188 $(wildcard $(SERVICES_DIR)/*.h) |
|
189 CONFIG_H := $(wildcard $(CONFIG_DIR)/*.h) \ |
|
190 $(wildcard $(BUILD_DIR)/config/*.h) \ |
|
191 $(FTMODULE_H) \ |
|
192 $(FTOPTION_H) |
|
193 DEVEL_H := $(wildcard $(TOP_DIR)/devel/*.h) |
|
194 |
|
195 FREETYPE_H := $(PUBLIC_H) $(INTERNAL_H) $(CONFIG_H) $(DEVEL_H) |
|
196 |
|
197 |
|
198 # ftsystem component |
|
199 # |
|
200 FTSYS_SRC ?= $(BASE_DIR)/ftsystem.c |
|
201 |
|
202 FTSYS_OBJ := $(OBJ_DIR)/ftsystem.$O |
|
203 |
|
204 OBJECTS_LIST += $(FTSYS_OBJ) |
|
205 |
|
206 $(FTSYS_OBJ): $(FTSYS_SRC) $(FREETYPE_H) |
|
207 $(FT_COMPILE) $T$(subst /,$(COMPILER_SEP),$@ $<) |
|
208 |
|
209 |
|
210 # ftdebug component |
|
211 # |
|
212 FTDEBUG_SRC ?= $(BASE_DIR)/ftdebug.c |
|
213 |
|
214 FTDEBUG_OBJ := $(OBJ_DIR)/ftdebug.$O |
|
215 |
|
216 OBJECTS_LIST += $(FTDEBUG_OBJ) |
|
217 |
|
218 $(FTDEBUG_OBJ): $(FTDEBUG_SRC) $(FREETYPE_H) |
|
219 $(FT_COMPILE) $T$(subst /,$(COMPILER_SEP),$@ $<) |
|
220 |
|
221 |
|
222 # Include all rule files from FreeType components. |
|
223 # |
|
224 include $(SRC_DIR)/base/rules.mk |
|
225 include $(patsubst %,$(SRC_DIR)/%/rules.mk,$(MODULES)) |
|
226 |
|
227 |
|
228 # ftinit component |
|
229 # |
|
230 # The C source `ftinit.c' contains the FreeType initialization routines. |
|
231 # It is able to automatically register one or more drivers when the API |
|
232 # function FT_Init_FreeType() is called. |
|
233 # |
|
234 # The set of initial drivers is determined by the driver Makefiles |
|
235 # includes above. Each driver Makefile updates the FTINIT_xxx lists |
|
236 # which contain additional include paths and macros used to compile the |
|
237 # single `ftinit.c' source. |
|
238 # |
|
239 FTINIT_SRC := $(BASE_DIR)/ftinit.c |
|
240 FTINIT_OBJ := $(OBJ_DIR)/ftinit.$O |
|
241 |
|
242 OBJECTS_LIST += $(FTINIT_OBJ) |
|
243 |
|
244 $(FTINIT_OBJ): $(FTINIT_SRC) $(FREETYPE_H) |
|
245 $(FT_COMPILE) $T$(subst /,$(COMPILER_SEP),$@ $<) |
|
246 |
|
247 |
|
248 # All FreeType library objects. |
|
249 # |
|
250 OBJ_M := $(BASE_OBJ_M) $(BASE_EXT_OBJ) $(DRV_OBJS_M) |
|
251 OBJ_S := $(BASE_OBJ_S) $(BASE_EXT_OBJ) $(DRV_OBJS_S) |
|
252 |
|
253 |
|
254 # The target `multi' on the Make command line indicates that we want to |
|
255 # compile each source file independently. |
|
256 # |
|
257 # Otherwise, each module/driver is compiled in a single object file through |
|
258 # source file inclusion (see `src/base/ftbase.c' or |
|
259 # `src/truetype/truetype.c' for examples). |
|
260 # |
|
261 BASE_OBJECTS := $(OBJECTS_LIST) |
|
262 |
|
263 ifneq ($(findstring multi,$(MAKECMDGOALS)),) |
|
264 OBJECTS_LIST += $(OBJ_M) |
|
265 else |
|
266 OBJECTS_LIST += $(OBJ_S) |
|
267 endif |
|
268 |
|
269 objects: $(OBJECTS_LIST) |
|
270 |
|
271 library: $(PROJECT_LIBRARY) |
|
272 |
|
273 .c.$O: |
|
274 $(FT_COMPILE) $T$(subst /,$(COMPILER_SEP),$@ $<) |
|
275 |
|
276 |
|
277 ifneq ($(findstring refdoc,$(MAKECMDGOALS)),) |
|
278 # poor man's `sed' emulation with make's built-in string functions |
|
279 work := $(strip $(shell $(CAT) $(PUBLIC_DIR)/freetype.h)) |
|
280 work := $(subst |,x,$(work)) |
|
281 work := $(subst $(space),|,$(work)) |
|
282 work := $(subst \#define|FREETYPE_MAJOR|,$(space),$(work)) |
|
283 work := $(word 2,$(work)) |
|
284 major := $(subst |,$(space),$(work)) |
|
285 major := $(firstword $(major)) |
|
286 |
|
287 work := $(subst \#define|FREETYPE_MINOR|,$(space),$(work)) |
|
288 work := $(word 2,$(work)) |
|
289 minor := $(subst |,$(space),$(work)) |
|
290 minor := $(firstword $(minor)) |
|
291 |
|
292 work := $(subst \#define|FREETYPE_PATCH|,$(space),$(work)) |
|
293 work := $(word 2,$(work)) |
|
294 patch := $(subst |,$(space),$(work)) |
|
295 patch := $(firstword $(patch)) |
|
296 |
|
297 version := $(major).$(minor).$(patch) |
|
298 endif |
|
299 |
|
300 # We write-protect the docmaker directory to suppress generation |
|
301 # of .pyc files. |
|
302 # |
|
303 refdoc: |
|
304 -chmod -w $(SRC_DIR)/tools/docmaker |
|
305 python $(SRC_DIR)/tools/docmaker/docmaker.py \ |
|
306 --prefix=ft2 \ |
|
307 --title=FreeType-$(version) \ |
|
308 --output=$(DOC_DIR) \ |
|
309 $(PUBLIC_DIR)/*.h \ |
|
310 $(PUBLIC_DIR)/config/*.h \ |
|
311 $(PUBLIC_DIR)/cache/*.h |
|
312 -chmod +w $(SRC_DIR)/tools/docmaker |
|
313 |
|
314 |
|
315 .PHONY: clean_project_std distclean_project_std |
|
316 |
|
317 # Standard cleaning and distclean rules. These are not accepted |
|
318 # on all systems though. |
|
319 # |
|
320 clean_project_std: |
|
321 -$(DELETE) $(BASE_OBJECTS) $(OBJ_M) $(OBJ_S) $(CLEAN) |
|
322 |
|
323 distclean_project_std: clean_project_std |
|
324 -$(DELETE) $(PROJECT_LIBRARY) |
|
325 -$(DELETE) *.orig *~ core *.core $(DISTCLEAN) |
|
326 |
|
327 |
|
328 .PHONY: clean_project_dos distclean_project_dos |
|
329 |
|
330 # The Dos command shell does not support very long list of arguments, so |
|
331 # we are stuck with wildcards. |
|
332 # |
|
333 # Don't break the command lines with \; this prevents the "del" command from |
|
334 # working correctly on Win9x. |
|
335 # |
|
336 clean_project_dos: |
|
337 -$(DELETE) $(subst /,$(SEP),$(OBJ_DIR)/*.$O $(CLEAN) $(NO_OUTPUT)) |
|
338 |
|
339 distclean_project_dos: clean_project_dos |
|
340 -$(DELETE) $(subst /,$(SEP),$(PROJECT_LIBRARY) $(DISTCLEAN) $(NO_OUTPUT)) |
|
341 |
|
342 |
|
343 .PHONY: remove_config_mk remove_ftmodule_h |
|
344 |
|
345 # Remove configuration file (used for distclean). |
|
346 # |
|
347 remove_config_mk: |
|
348 -$(DELETE) $(subst /,$(SEP),$(CONFIG_MK) $(NO_OUTPUT)) |
|
349 |
|
350 # Remove module list (used for distclean). |
|
351 # |
|
352 remove_ftmodule_h: |
|
353 -$(DELETE) $(subst /,$(SEP),$(FTMODULE_H) $(NO_OUTPUT)) |
|
354 |
|
355 |
|
356 .PHONY: clean distclean |
|
357 |
|
358 # The `config.mk' file must define `clean_freetype' and |
|
359 # `distclean_freetype'. Implementations may use to relay these to either |
|
360 # the `std' or `dos' versions from above, or simply provide their own |
|
361 # implementation. |
|
362 # |
|
363 clean: clean_project |
|
364 distclean: distclean_project remove_config_mk remove_ftmodule_h |
|
365 -$(DELETE) $(subst /,$(SEP),$(DOC_DIR)/*.html $(NO_OUTPUT)) |
|
366 |
|
367 |
|
368 # EOF |