Understand Buildroot System

- GENTARGETS(package, freetype)
$(call GENTARGETS_INNER,FREETYPE,$(call UPPERCASE,FREETYPE),$(call UPPERCASE,FREETYPE),$(1),target)
GENTARGETS_INNER(freetype, FREETYPE, FREETYPE, package, target)




- GENTARGETS_INNER
GENTARGETS_INNER(freetype, FREETYPE, FREETYPE, package, target)
{
FREETYPE_TYPE                   =  target
FREETYPE_NAME =  freetype
FREETYPE_VERSION =  $(FREETYPE_VERSION) --> 2.4.3
FREETYPE_DIR =  $(BUILD_DIR)/freetype-$(FREETYPE_VERSION); 1st expand
=  .../output/build/freetype-2.4.3 ; 2st expand
FREETYPE_SOURCE ?= ...
FREETYPE_SITE ?= ...
FREETYPE_DEPENDENCIES ?= ...
FREETYPE_INSTALL_STAGING ?= NO
FREETYPE_INSTALL_TARGET ?= YES
FREETYPE_DIR_PREFIX = //todo;$(if $(4),$(4),$(TOP_SRCDIR)/package)




FREETYPE_TARGET_INSTALL_TARGET = $$(FREETYPE_DIR)/.stamp_target_installed
FREETYPE_TARGET_INSTALL_STAGING = $$(FREETYPE_DIR)/.stamp_staging_installed
FREETYPE_TARGET_INSTALL_HOST = $$(FREETYPE_DIR)/.stamp_host_installed
FREETYPE_TARGET_BUILD = $$(FREETYPE_DIR)/.stamp_built
FREETYPE_TARGET_CONFIGURE = $$(FREETYPE_DIR)/.stamp_configured
FREETYPE_TARGET_PATCH = $$(FREETYPE_DIR)/.stamp_patched
FREETYPE_TARGET_EXTRACT = $$(FREETYPE_DIR)/.stamp_extracted
FREETYPE_TARGET_SOURCE = $$(FREETYPE_DIR)/.stamp_downloaded
FREETYPE_TARGET_UNINSTALL = $$(FREETYPE_DIR)/.stamp_uninstalled
FREETYPE_TARGET_CLEAN = $$(FREETYPE_DIR)/.stamp_cleaned
FREETYPE_TARGET_DIRCLEAN = $$(FREETYPE_DIR)/.stamp_dircleaned


FREETYPE_POST_EXTRACT_HOOKS         ?= ...
FREETYPE_POST_PATCH_HOOKS           ?= ...
FREETYPE_POST_CONFIGURE_HOOKS       ?= ...
FREETYPE_POST_BUILD_HOOKS           ?= ...
FREETYPE_POST_INSTALL_HOOKS         ?= ...
FREETYPE_POST_INSTALL_STAGING_HOOKS ?= ...
FREETYPE_POST_INSTALL_TARGET_HOOKS  ?= ...


#$(1): $(1)-install
freetype: freetype-install


#$(1)-install: $(1)-install-staging $(1)-install-target $$($(2)_HOOK_POST_INSTALL)
freetype-install: freetype-install-staging freetype-install-target $(FREETYPE_HOOK_POST_INSTALL)


#$(1)-install-target: $(BUILD_DIR)/$(1)/aaabbbcccc $(1)-build $$($(2)_TARGET_INSTALL_TARGET)
freetype-install-target: freetype-build $(FREETYPE_TARGET_INSTALL_TARGET)


#$(1)-install-staging: $(1)-build $$($(2)_TARGET_INSTALL_STAGING)
freetype-install-staging: freetype-build $(FREETYPE_TARGET_INSTALL_STAGING)


#$(1)-build: $(1)-configure $$($(2)_TARGET_BUILD) $$($(2)_HOOK_POST_BUILD)
freetype-build: freetype-configure $(FREETYPE_TARGET_BUILD) $(FREETYPE_HOOK_POST_BUILD)


#$(1)-configure: $(1)-patch $$($(2)_TARGET_CONFIGURE) $$($(2)_HOOK_POST_CONFIGURE)
freetype-configure: freetype-patch $(FREETYPE_TARGET_CONFIGURE) $(FREETYPE_HOOK_POST_CONFIGURE)


#$(1)-patch: $(1)-extract $$($(2)_TARGET_PATCH)
freetype-patch: freetype-extract $(FREETYPE_TARGET_PATCH)


#$(1)-extract: $(1)-depends $$($(2)_TARGET_EXTRACT) $$($(2)_HOOK_POST_EXTRACT)
freetype-extract: freetype-depends $(FREETYPE_TARGET_EXTRACT) $(FREETYPE_HOOK_POST_EXTRACT)


#$(1)-depends: $(1)-source $$($(2)_DEPENDENCIES)
freetype-depends: freetype-source $(FREETYPE_DEPENDENCIES)


$(1)-show-depends:
@echo $$($(2)_DEPENDENCIES)


#$(1)-source: $$($(2)_TARGET_SOURCE)
freetype-source: $(FREETYPE_TARGET_SOURCE)


# define the PKG variable for all targets, containing the
# uppercase package variable prefix
$(FREETYPE_TARGET_INSTALL_TARGET): PKG=FREETYPE#zzz: The variable PKG will be used when run $(FREETYPE_TARGET_INSTALL_TARGET):
$(FREETYPE_TARGET_INSTALL_STAGING): PKG=FREETYPE
$(FREETYPE_TARGET_EXTINST_TARGET): PKG=FREETYPE
$(FREETYPE_TARGET_EXTINST_STAGING): PKG=FREETYPE
$(FREETYPE_TARGET_EXTINST_HOST): PKG=FREETYPE
$(FREETYPE_TARGET_INSTALL_HOST): PKG=FREETYPE
$(FREETYPE_TARGET_BUILD): PKG=FREETYPE
$(FREETYPE_TARGET_CONFIGURE): PKG=FREETYPE
$(FREETYPE_TARGET_PATCH): PKG=FREETYPE
$(FREETYPE_TARGET_PATCH): NOHOSTPKG=FREETYPE
$(FREETYPE_TARGET_EXTRACT): PKG=FREETYPE
$(FREETYPE_TARGET_SOURCE): PKG=FREETYPE
$(FREETYPE_TARGET_UNINSTALL): PKG=FREETYPE
$(FREETYPE_TARGET_CLEAN): PKG=FREETYPE
$(FREETYPE_TARGET_DIRCLEAN): PKG=FREETYPE
$(FREETYPE_HOOK_POST_EXTRACT): PKG=FREETYPE
$(FREETYPE_HOOK_POST_CONFIGURE): PKG=FREETYPE
$(FREETYPE_HOOK_POST_BUILD): PKG=FREETYPE
$(FREETYPE_HOOK_POST_INSTALL): PKG=FREETYPE


TARGETS += freetype
}




################################################################################
# Implicit targets -- produce a stamp file for each step of a package build
################################################################################


# Retrieve the archive
.../output/build/freetype-2.4.3/.stamp_downloaded:
# support make source-check/external-deps
ifeq ($(SPIDER),)
# Only show the download message if it isn't already downloaded
$(Q)(test -e $(DL_DIR)/$($(PKG)_SOURCE) && \
(test -z $($(PKG)_PATCH) || test -e $(DL_DIR)$($(PKG)_PATCH))) || \
$(call MESSAGE,"Downloading")
endif
$(call DOWNLOAD,$($(PKG)_SITE),$($(PKG)_SOURCE))
$(if $($(PKG)_PATCH),$(call DOWNLOAD,$($(PKG)_SITE),$($(PKG)_PATCH)))
ifeq ($(SPIDER),)
$(Q)mkdir -p $(@D)
$(Q)touch $@
endif


# Unpack the archive
#$(BUILD_DIR)/%/.stamp_extracted:
.../output/build/freetype-2.4.3/.stamp_extracted:
@$(call MESSAGE,"Extracting")
$(Q)mkdir -p $(@D)
$(Q)$(INFLATE$(suffix $($(PKG)_SOURCE))) $(DL_DIR)/$($(PKG)_SOURCE) | \
$(TAR) $(TAR_STRIP_COMPONENTS)=1 -C $(@D) $(TAR_OPTIONS) -
# some packages have messed up permissions inside
$(Q)chmod -R ug+rw $(@D)
$(foreach hook,$($(PKG)_POST_EXTRACT_HOOKS),$(call $(hook))$(sep))
$(Q)touch $@


# Patch
#
# The NOHOSTPKG variable is the uppercased package name, without the
# HOST_ prefix, even for host packages. This allows to find the
# patches in the package directory, because $($(NOHOSTPKG)_NAME)
# expands to the package directory name.
#
.../output/build/freetype-2.4.3/.stamp_patched: NAMEVER = $($(NOHOSTPKG)_NAME)-$($(PKG)_VERSION)
.../output/build/freetype-2.4.3/.stamp_patched:
@$(call MESSAGE,"Patching $($(PKG)_DIR_PREFIX)/$($(PKG)_NAME)")
$(if $($(PKG)_PATCH),toolchain/patch-kernel.sh $(@D) $(DL_DIR) $($(PKG)_PATCH))
$(Q)( \
if test -d $($(PKG)_DIR_PREFIX)/$($(NOHOSTPKG)_NAME); then \
 if test "$(wildcard $($(PKG)_DIR_PREFIX)/$($(NOHOSTPKG)_NAME)/$(NAMEVER)*.patch*)"; then \
   toolchain/patch-kernel.sh $(@D) $($(PKG)_DIR_PREFIX)/$($(NOHOSTPKG)_NAME) $(NAMEVER)\*.patch $(NAMEVER)\*.patch.$(ARCH) || exit 1; \
 else \
   toolchain/patch-kernel.sh $(@D) $($(PKG)_DIR_PREFIX)/$($(NOHOSTPKG)_NAME) $($(NOHOSTPKG)_NAME)\*.patch $($(NOHOSTPKG)_NAME)\*.patch.$(ARCH) || exit 1; \
   if test -d $($(PKG)_DIR_PREFIX)/$($(PKG)_NAME)/$(NAMEVER); then \
     toolchain/patch-kernel.sh $(@D) $($(PKG)_DIR_PREFIX)/$($(NOHOSTPKG)_NAME)/$(NAMEVER) \*.patch \*.patch.$(ARCH) || exit 1; \
   fi; \
 fi; \
fi; \
)
$(foreach hook,$($(PKG)_POST_PATCH_HOOKS),$(call $(hook))$(sep))
$(Q)touch $@


# Configure
.../output/build/freetype-2.4.3/.stamp_configured:
@$(call MESSAGE,"Configuring")
$($(PKG)_CONFIGURE_CMDS)
$(foreach hook,$($(PKG)_POST_CONFIGURE_HOOKS),$(call $(hook))$(sep))
$(Q)touch $@


# Build
.../output/build/freetype-2.4.3/.stamp_built::
@$(call MESSAGE,"Building")
$($(PKG)_BUILD_CMDS)
$(foreach hook,$($(PKG)_POST_BUILD_HOOKS),$(call $(hook))$(sep))
$(Q)touch $@


# Install to host dir
.../output/build/freetype-2.4.3/.stamp_host_installed:
@$(call MESSAGE,'Installing to host directory')
$($(PKG)_INSTALL_CMDS)
$(foreach hook,$($(PKG)_POST_INSTALL_HOOKS),$(call $(hook))$(sep))
$(Q)touch $@


# Install to staging dir
.../output/build/freetype-2.4.3/.stamp_staging_installed:
@$(call MESSAGE,'Installing to staging directory')
$($(PKG)_INSTALL_STAGING_CMDS)
$(foreach hook,$($(PKG)_POST_INSTALL_STAGING_HOOKS),$(call $(hook))$(sep))
$(Q)touch $@


# Install to target dir
.../output/build/freetype-2.4.3/.stamp_target_installed:
@$(call MESSAGE,"Installing to target")
$($(PKG)_INSTALL_TARGET_CMDS)
$(foreach hook,$($(PKG)_POST_INSTALL_TARGET_HOOKS),$(call $(hook))$(sep))
$(Q)touch $@


# Clean package
.../output/build/freetype-2.4.3/.stamp_cleaned:
@$(call MESSAGE,"Cleaning up")
$($(PKG)_CLEAN_CMDS)
rm -f $(@D)/.stamp_built


# Uninstall package from target and staging
.../output/build/freetype-2.4.3/.stamp_uninstalled:
@$(call MESSAGE,"Uninstalling")
$($(PKG)_UNINSTALL_STAGING_CMDS)
rm -f $($(PKG)_TARGET_INSTALL_STAGING)
$($(PKG)_UNINSTALL_TARGET_CMDS)
rm -f $($(PKG)_TARGET_INSTALL_TARGET) $($(PKG)_HOOK_POST_INSTALL)


# Remove package sources
.../output/build/freetype-2.4.3/.stamp_dircleaned:
rm -Rf $(@D)