modules/freetype2/builds/freetype.mk

Thu, 22 Jan 2015 13:21:57 +0100

author
Michael Schloh von Bennewitz <michael@schloh.com>
date
Thu, 22 Jan 2015 13:21:57 +0100
branch
TOR_BUG_9701
changeset 15
b8a032363ba2
permissions
-rw-r--r--

Incorporate requested changes from Mozilla in review:
https://bugzilla.mozilla.org/show_bug.cgi?id=1123480#c6

     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

mercurial