Wed, 31 Dec 2014 06:09:35 +0100
Cloned upstream origin tor-browser at tor-browser-31.3.0esr-4.5-1-build1
revision ID fc1c9ff7c1b2defdbc039f12214767608f46423f for hacking purpose.
1 #
2 # FreeType 2 library sub-Makefile
3 #
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.
16 # DO NOT INVOKE THIS MAKEFILE DIRECTLY! IT IS MEANT TO BE INCLUDED BY
17 # OTHER MAKEFILES.
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.
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
80 # default target -- build single objects and library
81 #
82 single: objects library
84 # `multi' target -- build multiple objects and library
85 #
86 multi: objects library
89 # The FreeType source directory, usually `./src'.
90 #
91 SRC_DIR := $(TOP_DIR)/src
93 # The directory where the base layer components are placed, usually
94 # `./src/base'.
95 #
96 BASE_DIR := $(SRC_DIR)/base
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
105 # The documentation directory.
106 #
107 DOC_DIR ?= $(TOP_DIR)/docs/reference
109 # The final name of the library file.
110 #
111 PROJECT_LIBRARY := $(LIB_DIR)/$(LIBRARY).$A
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)
127 INCLUDE_FLAGS := $(INCLUDES:%=$I%)
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
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
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)
169 # Include the `exports' rules file.
170 #
171 include $(TOP_DIR)/builds/exports.mk
174 # Initialize the list of objects.
175 #
176 OBJECTS_LIST :=
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)
195 FREETYPE_H := $(PUBLIC_H) $(INTERNAL_H) $(CONFIG_H) $(DEVEL_H)
198 # ftsystem component
199 #
200 FTSYS_SRC ?= $(BASE_DIR)/ftsystem.c
202 FTSYS_OBJ := $(OBJ_DIR)/ftsystem.$O
204 OBJECTS_LIST += $(FTSYS_OBJ)
206 $(FTSYS_OBJ): $(FTSYS_SRC) $(FREETYPE_H)
207 $(FT_COMPILE) $T$(subst /,$(COMPILER_SEP),$@ $<)
210 # ftdebug component
211 #
212 FTDEBUG_SRC ?= $(BASE_DIR)/ftdebug.c
214 FTDEBUG_OBJ := $(OBJ_DIR)/ftdebug.$O
216 OBJECTS_LIST += $(FTDEBUG_OBJ)
218 $(FTDEBUG_OBJ): $(FTDEBUG_SRC) $(FREETYPE_H)
219 $(FT_COMPILE) $T$(subst /,$(COMPILER_SEP),$@ $<)
222 # Include all rule files from FreeType components.
223 #
224 include $(SRC_DIR)/base/rules.mk
225 include $(patsubst %,$(SRC_DIR)/%/rules.mk,$(MODULES))
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
242 OBJECTS_LIST += $(FTINIT_OBJ)
244 $(FTINIT_OBJ): $(FTINIT_SRC) $(FREETYPE_H)
245 $(FT_COMPILE) $T$(subst /,$(COMPILER_SEP),$@ $<)
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)
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)
263 ifneq ($(findstring multi,$(MAKECMDGOALS)),)
264 OBJECTS_LIST += $(OBJ_M)
265 else
266 OBJECTS_LIST += $(OBJ_S)
267 endif
269 objects: $(OBJECTS_LIST)
271 library: $(PROJECT_LIBRARY)
273 .c.$O:
274 $(FT_COMPILE) $T$(subst /,$(COMPILER_SEP),$@ $<)
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))
287 work := $(subst \#define|FREETYPE_MINOR|,$(space),$(work))
288 work := $(word 2,$(work))
289 minor := $(subst |,$(space),$(work))
290 minor := $(firstword $(minor))
292 work := $(subst \#define|FREETYPE_PATCH|,$(space),$(work))
293 work := $(word 2,$(work))
294 patch := $(subst |,$(space),$(work))
295 patch := $(firstword $(patch))
297 version := $(major).$(minor).$(patch)
298 endif
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
315 .PHONY: clean_project_std distclean_project_std
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)
323 distclean_project_std: clean_project_std
324 -$(DELETE) $(PROJECT_LIBRARY)
325 -$(DELETE) *.orig *~ core *.core $(DISTCLEAN)
328 .PHONY: clean_project_dos distclean_project_dos
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))
339 distclean_project_dos: clean_project_dos
340 -$(DELETE) $(subst /,$(SEP),$(PROJECT_LIBRARY) $(DISTCLEAN) $(NO_OUTPUT))
343 .PHONY: remove_config_mk remove_ftmodule_h
345 # Remove configuration file (used for distclean).
346 #
347 remove_config_mk:
348 -$(DELETE) $(subst /,$(SEP),$(CONFIG_MK) $(NO_OUTPUT))
350 # Remove module list (used for distclean).
351 #
352 remove_ftmodule_h:
353 -$(DELETE) $(subst /,$(SEP),$(FTMODULE_H) $(NO_OUTPUT))
356 .PHONY: clean distclean
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))
368 # EOF