• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1#
2# FreeType 2 library sub-Makefile
3#
4
5
6# Copyright (C) 1996-2020 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 refdoc-venv
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
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 `builds/<system>' directory, as these files will
120#                 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# For a development build, we assume that the external library dependencies
130# defined in `ftoption.h' are fulfilled, so we directly access the necessary
131# include directory information using `pkg-config'.
132#
133ifdef DEVEL_DIR
134  INCLUDE_FLAGS += $(shell pkg-config --cflags libpng)
135  INCLUDE_FLAGS += $(shell pkg-config --cflags harfbuzz)
136  INCLUDE_FLAGS += $(shell pkg-config --cflags libbrotlidec)
137endif
138
139
140# C flags used for the compilation of an object file.  This must include at
141# least the paths for the `base' and `builds/<system>' directories;
142# debug/optimization/warning flags + ansi compliance if needed.
143#
144# $(INCLUDE_FLAGS) should come before $(CFLAGS) to avoid problems with
145# old FreeType versions.
146#
147# Note what we also define the macro FT2_BUILD_LIBRARY when building
148# FreeType.  This is required to let our sources include the internal
149# headers (something forbidden by clients).
150#
151# `CPPFLAGS' might be specified by the user in the environment.
152#
153FT_CFLAGS  = $(CPPFLAGS) \
154             $(CFLAGS) \
155             $DFT2_BUILD_LIBRARY
156
157FT_COMPILE := $(CC) $(ANSIFLAGS) $(INCLUDE_FLAGS) $(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.  $(FTOPTION_H) is the option file used in the compilation.
173#
174# This is used to simplify the dependency rules -- if one of these files
175# changes, the whole library is recompiled.
176#
177ifneq ($(wildcard $(OBJ_DIR)/ftoption.h),)
178  FTOPTION_H    := $(OBJ_DIR)/ftoption.h
179else ifneq ($(wildcard $(BUILD_DIR)/ftoption.h),)
180  FTOPTION_H    := $(BUILD_DIR)/ftoption.h
181endif
182
183PUBLIC_H   := $(wildcard $(PUBLIC_DIR)/*.h)
184INTERNAL_H := $(wildcard $(INTERNAL_DIR)/*.h) \
185              $(wildcard $(SERVICES_DIR)/*.h)
186CONFIG_H   := $(wildcard $(CONFIG_DIR)/*.h) \
187              $(wildcard $(BUILD_DIR)/config/*.h) \
188              $(FTMODULE_H) \
189              $(FTOPTION_H)
190DEVEL_H    := $(wildcard $(TOP_DIR)/devel/*.h)
191
192FREETYPE_H := $(PUBLIC_H) $(INTERNAL_H) $(CONFIG_H) $(DEVEL_H)
193
194
195# ftsystem component
196#
197FTSYS_SRC ?= $(BASE_DIR)/ftsystem.c
198
199FTSYS_OBJ := $(OBJ_DIR)/ftsystem.$O
200
201OBJECTS_LIST += $(FTSYS_OBJ)
202
203$(FTSYS_OBJ): $(FTSYS_SRC) $(FREETYPE_H)
204	$(FT_COMPILE) $T$(subst /,$(COMPILER_SEP),$@ $<)
205
206
207# ftdebug component
208#
209FTDEBUG_SRC ?= $(BASE_DIR)/ftdebug.c
210
211FTDEBUG_OBJ := $(OBJ_DIR)/ftdebug.$O
212
213OBJECTS_LIST += $(FTDEBUG_OBJ)
214
215$(FTDEBUG_OBJ): $(FTDEBUG_SRC) $(FREETYPE_H)
216	$(FT_COMPILE) $T$(subst /,$(COMPILER_SEP),$@ $<)
217
218
219# Include all rule files from FreeType components.
220#
221include $(SRC_DIR)/base/rules.mk
222include $(patsubst %,$(SRC_DIR)/%/rules.mk,$(MODULES))
223
224
225# ftinit component
226#
227#   The C source `ftinit.c' contains the FreeType initialization routines.
228#   It is able to automatically register one or more drivers when the API
229#   function FT_Init_FreeType() is called.
230#
231#   The set of initial drivers is determined by the driver Makefiles
232#   includes above.  Each driver Makefile updates the FTINIT_xxx lists
233#   which contain additional include paths and macros used to compile the
234#   single `ftinit.c' source.
235#
236FTINIT_SRC := $(BASE_DIR)/ftinit.c
237FTINIT_OBJ := $(OBJ_DIR)/ftinit.$O
238
239OBJECTS_LIST += $(FTINIT_OBJ)
240
241$(FTINIT_OBJ): $(FTINIT_SRC) $(FREETYPE_H)
242	$(FT_COMPILE) $T$(subst /,$(COMPILER_SEP),$@ $<)
243
244
245# ftver component
246#
247#  The VERSIONINFO resource `ftver.rc' contains version and copyright
248#  to be compiled by windres and tagged into DLL usually.
249#
250ifneq ($(RC),)
251  FTVER_SRC := $(BASE_DIR)/ftver.rc
252  FTVER_OBJ := $(OBJ_DIR)/ftver.$O
253
254  OBJECTS_LIST += $(FTVER_OBJ)
255
256  $(FTVER_OBJ): $(FTVER_SRC)
257	$(RC) -o $@ $<
258endif
259
260
261# All FreeType library objects.
262#
263OBJ_M := $(BASE_OBJ_M) $(BASE_EXT_OBJ) $(DRV_OBJS_M)
264OBJ_S := $(BASE_OBJ_S) $(BASE_EXT_OBJ) $(DRV_OBJS_S)
265
266
267# The target `multi' on the Make command line indicates that we want to
268# compile each source file independently.
269#
270# Otherwise, each module/driver is compiled in a single object file through
271# source file inclusion (see `src/base/ftbase.c' or
272# `src/truetype/truetype.c' for examples).
273#
274BASE_OBJECTS := $(OBJECTS_LIST)
275
276ifneq ($(findstring multi,$(MAKECMDGOALS)),)
277  OBJECTS_LIST += $(OBJ_M)
278else
279  OBJECTS_LIST += $(OBJ_S)
280endif
281
282objects: $(OBJECTS_LIST)
283
284library: $(PROJECT_LIBRARY)
285
286# Run `docwriter' in the current Python environment.
287#
288PYTHON ?= python
289
290refdoc:
291	@echo Running docwriter...
292	$(PYTHON) -m docwriter \
293                  --prefix=ft2 \
294                  --title=FreeType-$(version) \
295                  --site=reference \
296                  --output=$(DOC_DIR) \
297                  $(PUBLIC_DIR)/*.h \
298                  $(PUBLIC_DIR)/config/*.h \
299                  $(PUBLIC_DIR)/cache/*.h
300	@echo Building static site...
301	cd $(DOC_DIR) && mkdocs build
302	@echo Done.
303
304# Variables for running `refdoc' with Python's `virtualenv'.  The
305# environment is created in `DOC_DIR/env' and is gitignored.
306#
307# We still need to cd into `DOC_DIR' to build `mkdocs' because paths in
308# `mkdocs.yml' are relative to the current working directory.
309#
310VENV_NAME  := env
311VENV_DIR   := $(DOC_DIR)$(SEP)$(VENV_NAME)
312ENV_PYTHON := $(VENV_DIR)$(SEP)$(BIN)$(SEP)$(PYTHON)
313
314refdoc-venv:
315	@echo Setting up virtualenv for Python...
316	virtualenv --python=$(PYTHON) $(VENV_DIR)
317	@echo Installing docwriter...
318	$(ENV_PYTHON) -m pip install docwriter
319	@echo Running docwriter...
320	$(ENV_PYTHON) -m docwriter \
321                      --prefix=ft2 \
322                      --title=FreeType-$(version) \
323                      --site=reference \
324                      --output=$(DOC_DIR) \
325                      $(PUBLIC_DIR)/*.h \
326                      $(PUBLIC_DIR)/config/*.h \
327                      $(PUBLIC_DIR)/cache/*.h
328	@echo Building static site...
329	cd $(DOC_DIR) && $(VENV_NAME)$(SEP)$(BIN)$(SEP)python -m mkdocs build
330	@echo Done.
331
332.PHONY: clean_project_std distclean_project_std
333
334# Standard cleaning and distclean rules.  These are not accepted
335# on all systems though.
336#
337clean_project_std:
338	-$(DELETE) $(BASE_OBJECTS) $(OBJ_M) $(OBJ_S) $(CLEAN)
339
340distclean_project_std: clean_project_std
341	-$(DELETE) $(PROJECT_LIBRARY)
342	-$(DELETE) *.orig *~ core *.core $(DISTCLEAN)
343
344
345.PHONY: clean_project_dos distclean_project_dos
346
347# The Dos command shell does not support very long list of arguments, so
348# we are stuck with wildcards.
349#
350# Don't break the command lines with \; this prevents the "del" command from
351# working correctly on Win9x.
352#
353clean_project_dos:
354	-$(DELETE) $(subst /,$(SEP),$(OBJ_DIR)/*.$O $(CLEAN) $(NO_OUTPUT))
355
356distclean_project_dos: clean_project_dos
357	-$(DELETE) $(subst /,$(SEP),$(PROJECT_LIBRARY) $(DISTCLEAN) $(NO_OUTPUT))
358
359
360.PHONY: remove_config_mk remove_ftmodule_h
361
362# Remove configuration file (used for distclean).
363#
364remove_config_mk:
365	-$(DELETE) $(subst /,$(SEP),$(CONFIG_MK) $(NO_OUTPUT))
366
367# Remove module list (used for distclean).
368#
369remove_ftmodule_h:
370	-$(DELETE) $(subst /,$(SEP),$(FTMODULE_H) $(NO_OUTPUT))
371
372
373.PHONY: clean distclean
374
375# The `config.mk' file must define `clean_project' and `distclean_project'.
376# Implementations may use to relay these to either the `std' or `dos'
377# versions from above, or simply provide their own implementation.
378#
379clean: clean_project
380distclean: distclean_project remove_config_mk remove_ftmodule_h
381	-$(DELETE) $(subst /,$(SEP),$(DOC_DIR)/*.html $(NO_OUTPUT))
382
383
384# EOF
385