/modules/freetype2/builds/freetype.mk

  1#
  2# FreeType 2 library sub-Makefile
  3#
  4
  5
  6# Copyright 1996-2000, 2001, 2002, 2003, 2004, 2005, 2006, 2008 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#
 82single: objects library
 83
 84# `multi' target -- build multiple objects and library
 85#
 86multi: objects library
 87
 88
 89# The FreeType source directory, usually `./src'.
 90#
 91SRC_DIR := $(TOP_DIR)/src
 92
 93# The directory where the base layer components are placed, usually
 94# `./src/base'.
 95#
 96BASE_DIR := $(SRC_DIR)/base
 97
 98# Other derived directories.
 99#
100PUBLIC_DIR   := $(TOP_DIR)/include/freetype
101INTERNAL_DIR := $(PUBLIC_DIR)/internal
102SERVICES_DIR := $(INTERNAL_DIR)/services
103CONFIG_DIR   := $(PUBLIC_DIR)/config
104
105# The documentation directory.
106#
107DOC_DIR ?= $(TOP_DIR)/docs/reference
108
109# The final name of the library file.
110#
111PROJECT_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 `freetype/builds/<system>' directory, as these
120#                 files will override the default sources.
121#
122INCLUDES := $(subst /,$(COMPILER_SEP),$(OBJ_DIR) \
123                                      $(DEVEL_DIR) \
124                                      $(BUILD_DIR) \
125                                      $(TOP_DIR)/include)
126
127INCLUDE_FLAGS := $(INCLUDES:%=$I%)
128
129
130# C flags used for the compilation of an object file.  This must include at
131# least the paths for the `base' and `builds/<system>' directories;
132# debug/optimization/warning flags + ansi compliance if needed.
133#
134# $(INCLUDE_FLAGS) should come before $(CFLAGS) to avoid problems with
135# old FreeType versions.
136#
137# Note what we also define the macro FT2_BUILD_LIBRARY when building
138# FreeType.  This is required to let our sources include the internal
139# headers (something forbidden by clients).
140#
141# Finally, we define FT_CONFIG_MODULES_H so that the compiler uses the
142# generated version of `ftmodule.h' in $(OBJ_DIR).  If there is an
143# `ftoption.h' files in $(OBJ_DIR), define FT_CONFIG_OPTIONS_H too.
144#
145ifneq ($(wildcard $(OBJ_DIR)/ftoption.h),)
146  FTOPTION_H    := $(OBJ_DIR)/ftoption.h
147  FTOPTION_FLAG := $DFT_CONFIG_OPTIONS_H="<ftoption.h>"
148endif
149
150FT_CFLAGS  = $(CPPFLAGS) \
151             $(INCLUDE_FLAGS) \
152             $(CFLAGS) \
153             $DFT2_BUILD_LIBRARY \
154             $DFT_CONFIG_MODULES_H="<ftmodule.h>" \
155             $(FTOPTION_FLAG)
156FT_CC      = $(CC) $(FT_CFLAGS)
157FT_COMPILE = $(CC) $(ANSIFLAGS) $(FT_CFLAGS)
158
159
160# Include the `exports' rules file.
161#
162include $(TOP_DIR)/builds/exports.mk
163
164
165# Initialize the list of objects.
166#
167OBJECTS_LIST :=
168
169
170# Define $(PUBLIC_H) as the list of all public header files located in
171# `$(TOP_DIR)/include/freetype'.  $(INTERNAL_H), and $(CONFIG_H) are defined
172# similarly.
173#
174# This is used to simplify the dependency rules -- if one of these files
175# changes, the whole library is recompiled.
176#
177PUBLIC_H   := $(wildcard $(PUBLIC_DIR)/*.h)
178INTERNAL_H := $(wildcard $(INTERNAL_DIR)/*.h) \
179              $(wildcard $(SERVICES_DIR)/*.h)
180CONFIG_H   := $(wildcard $(CONFIG_DIR)/*.h) \
181              $(wildcard $(BUILD_DIR)/freetype/config/*.h) \
182              $(FTMODULE_H) \
183              $(FTOPTION_H)
184DEVEL_H    := $(wildcard $(TOP_DIR)/devel/*.h)
185
186FREETYPE_H := $(PUBLIC_H) $(INTERNAL_H) $(CONFIG_H) $(DEVEL_H)
187
188
189# ftsystem component
190#
191FTSYS_SRC ?= $(BASE_DIR)/ftsystem.c
192
193FTSYS_OBJ := $(OBJ_DIR)/ftsystem.$O
194
195OBJECTS_LIST += $(FTSYS_OBJ)
196
197$(FTSYS_OBJ): $(FTSYS_SRC) $(FREETYPE_H)
198	$(FT_COMPILE) $T$(subst /,$(COMPILER_SEP),$@ $<)
199
200
201# ftdebug component
202#
203FTDEBUG_SRC ?= $(BASE_DIR)/ftdebug.c
204
205FTDEBUG_OBJ := $(OBJ_DIR)/ftdebug.$O
206
207OBJECTS_LIST += $(FTDEBUG_OBJ)
208
209$(FTDEBUG_OBJ): $(FTDEBUG_SRC) $(FREETYPE_H)
210	$(FT_COMPILE) $T$(subst /,$(COMPILER_SEP),$@ $<)
211
212
213# Include all rule files from FreeType components.
214#
215include $(SRC_DIR)/base/rules.mk
216include $(patsubst %,$(SRC_DIR)/%/rules.mk,$(MODULES))
217
218
219# ftinit component
220#
221#   The C source `ftinit.c' contains the FreeType initialization routines.
222#   It is able to automatically register one or more drivers when the API
223#   function FT_Init_FreeType() is called.
224#
225#   The set of initial drivers is determined by the driver Makefiles
226#   includes above.  Each driver Makefile updates the FTINIT_xxx lists
227#   which contain additional include paths and macros used to compile the
228#   single `ftinit.c' source.
229#
230FTINIT_SRC := $(BASE_DIR)/ftinit.c
231FTINIT_OBJ := $(OBJ_DIR)/ftinit.$O
232
233OBJECTS_LIST += $(FTINIT_OBJ)
234
235$(FTINIT_OBJ): $(FTINIT_SRC) $(FREETYPE_H)
236	$(FT_COMPILE) $T$(subst /,$(COMPILER_SEP),$@ $<)
237
238
239# All FreeType library objects.
240#
241OBJ_M := $(BASE_OBJ_M) $(BASE_EXT_OBJ) $(DRV_OBJS_M)
242OBJ_S := $(BASE_OBJ_S) $(BASE_EXT_OBJ) $(DRV_OBJS_S)
243
244
245# The target `multi' on the Make command line indicates that we want to
246# compile each source file independently.
247#
248# Otherwise, each module/driver is compiled in a single object file through
249# source file inclusion (see `src/base/ftbase.c' or
250# `src/truetype/truetype.c' for examples).
251#
252BASE_OBJECTS := $(OBJECTS_LIST)
253
254ifneq ($(findstring multi,$(MAKECMDGOALS)),)
255  OBJECTS_LIST += $(OBJ_M)
256else
257  OBJECTS_LIST += $(OBJ_S)
258endif
259
260objects: $(OBJECTS_LIST)
261
262library: $(PROJECT_LIBRARY)
263
264dll: $(PROJECT_LIBRARY) exported_symbols
265
266.c.$O:
267	$(FT_COMPILE) $T$(subst /,$(COMPILER_SEP),$@ $<)
268
269
270ifneq ($(findstring refdoc,$(MAKECMDGOALS)),)
271  # poor man's `sed' emulation with make's built-in string functions
272  work := $(strip $(shell $(CAT) $(PUBLIC_DIR)/freetype.h))
273  work := $(subst |,x,$(work))
274  work := $(subst $(space),|,$(work))
275  work := $(subst \#define|FREETYPE_MAJOR|,$(space),$(work))
276  work := $(word 2,$(work))
277  major := $(subst |,$(space),$(work))
278  major := $(firstword $(major))
279
280  work := $(subst \#define|FREETYPE_MINOR|,$(space),$(work))
281  work := $(word 2,$(work))
282  minor := $(subst |,$(space),$(work))
283  minor := $(firstword $(minor))
284
285  work := $(subst \#define|FREETYPE_PATCH|,$(space),$(work))
286  work := $(word 2,$(work))
287  patch := $(subst |,$(space),$(work))
288  patch := $(firstword $(patch))
289
290  version := $(major).$(minor).$(patch)
291endif
292
293# We write-protect the docmaker directory to suppress generation
294# of .pyc files.
295#
296refdoc:
297	-chmod -w $(SRC_DIR)/tools/docmaker
298	python $(SRC_DIR)/tools/docmaker/docmaker.py \
299               --prefix=ft2                          \
300               --title=FreeType-$(version)           \
301               --output=$(DOC_DIR)                   \
302               $(PUBLIC_DIR)/*.h                     \
303               $(PUBLIC_DIR)/config/*.h              \
304               $(PUBLIC_DIR)/cache/*.h
305	-chmod +w $(SRC_DIR)/tools/docmaker
306
307
308.PHONY: clean_project_std distclean_project_std
309
310# Standard cleaning and distclean rules.  These are not accepted
311# on all systems though.
312#
313clean_project_std:
314	-$(DELETE) $(BASE_OBJECTS) $(OBJ_M) $(OBJ_S) $(CLEAN)
315
316distclean_project_std: clean_project_std
317	-$(DELETE) $(PROJECT_LIBRARY)
318	-$(DELETE) *.orig *~ core *.core $(DISTCLEAN)
319
320
321.PHONY: clean_project_dos distclean_project_dos
322
323# The Dos command shell does not support very long list of arguments, so
324# we are stuck with wildcards.
325#
326# Don't break the command lines with \; this prevents the "del" command from
327# working correctly on Win9x.
328#
329clean_project_dos:
330	-$(DELETE) $(subst /,$(SEP),$(OBJ_DIR)/*.$O $(CLEAN) $(NO_OUTPUT))
331
332distclean_project_dos: clean_project_dos
333	-$(DELETE) $(subst /,$(SEP),$(PROJECT_LIBRARY) $(DISTCLEAN) $(NO_OUTPUT))
334
335
336.PHONY: remove_config_mk remove_ftmodule_h
337
338# Remove configuration file (used for distclean).
339#
340remove_config_mk:
341	-$(DELETE) $(subst /,$(SEP),$(CONFIG_MK) $(NO_OUTPUT))
342
343# Remove module list (used for distclean).
344#
345remove_ftmodule_h:
346	-$(DELETE) $(subst /,$(SEP),$(FTMODULE_H) $(NO_OUTPUT))
347
348
349.PHONY: clean distclean
350
351# The `config.mk' file must define `clean_freetype' and
352# `distclean_freetype'.  Implementations may use to relay these to either
353# the `std' or `dos' versions from above, or simply provide their own
354# implementation.
355#
356clean: clean_project
357distclean: distclean_project remove_config_mk remove_ftmodule_h
358	-$(DELETE) $(subst /,$(SEP),$(DOC_DIR)/*.html $(NO_OUTPUT))
359
360
361# EOF