ScummVM/dockerized-bb
1
0
Fork 0
mirror of https://github.com/scummvm/dockerized-bb.git synced 2026-06-20 05:46:00 +00:00
Code Issues Packages Projects Releases Wiki Activity

ALL: Document Makefile and clean it up

Browse Source
This commit is contained in:
Le Philousophe
2020-04-11 10:03:51 +00:00
parent 2f382486a0
commit 5bf79ccd75
1 changed files with 68 additions and 23 deletions
Download Patch File Download Diff File Expand all files Collapse all files
Makefile
+68 -23
View File
@@ -4,23 +4,32 @@ VERBOSE =
BUILDDIR = .build
M4_DEBUG = -dcxaeq
nothing:
# Helpers
# Create dependencies list based on docker context contents
define MAKE_DEPS
$(BUILDDIR)/$(1): $(shell find $(1)/ -type f) | $(BUILDDIR)/$(patsubst %/,%,$(dir $(1)))
endef
# Create a dependency on common (used by toolchains) except when target is common
define DEPEND_COMMON
$(BUILDDIR)/$(1): $(if $(findstring /common,$(1)),,$(BUILDDIR)/$(dir $(1))common)
$(BUILDDIR)/$(1): \
$(if $(filter-out common,$(notdir $(1))), \
$(BUILDDIR)/$(dir $(1))common \
)
endef
# Create a dependency on the toolchain of same name if it exists (used by workers)
define DEPEND_TOOLCHAIN
$(BUILDDIR)/$(1): $(if $(wildcard toolchains/$(notdir $(1))),$(BUILDDIR)/toolchains/$(notdir $(1)))
$(BUILDDIR)/$(1): \
$(if $(wildcard toolchains/$(notdir $(1))), \
$(BUILDDIR)/toolchains/$(notdir $(1)) \
)
endef
# All these targets are directories that should be made
$(BUILDDIR) $(BUILDDIR)/toolchains $(BUILDDIR)/workers: %:
mkdir -p $@
# Debug informations
status:
@echo "Timestamps directory: " $(BUILDDIR)
@echo "Toolchains to preprocess: " $(TOOLCHAINS_M4)
@@ -32,39 +41,60 @@ status:
@echo "All workers: " $(WORKERS)
@echo "Workers timestamps: " $(WORKERS_TS)
# Debug ccache used by workers
ccache-stats:
@CCACHE_DIR=buildbot-data/ccache ccache -s
.PHONY: status ccache-stats
# Master rules
# Prerequisites are quite redundant but that makes no harm
master: $(BUILDDIR)/buildbot_installed master/buildbot.tac
.PHONY: master
# buildbot depend on Makefile as we modify version here
$(BUILDDIR)/buildbot_installed: Makefile | $(BUILDDIR)
pip install 'buildbot[bundle]==$(BUILDBOT_VERSION)'
touch $(BUILDDIR)/buildbot_installed
# Create startup file once buildbot is installed and up-to-date
master/buildbot.tac: $(BUILDDIR)/buildbot_installed
buildbot create-master -rf master
rm master/master.cfg.sample
touch master/buildbot.tac
# Toolchains rules
# List all toolchains: m4 based and raw Dockerfile based
TOOLCHAINS_M4=$(patsubst %/,%,$(dir $(wildcard toolchains/*/Dockerfile.m4)))
TOOLCHAINS_DOC=$(patsubst %/,%,$(dir $(wildcard toolchains/*/Dockerfile)))
TOOLCHAINS=$(TOOLCHAINS_M4) $(TOOLCHAINS_DOC)
# Build timestamps files generated as a marker
TOOLCHAINS_M4_TS=$(foreach i,$(TOOLCHAINS_M4),$(BUILDDIR)/$(i))
TOOLCHAINS_DOC_TS=$(foreach i,$(TOOLCHAINS_DOC),$(BUILDDIR)/$(i))
TOOLCHAINS_TS=$(TOOLCHAINS_M4_TS) $(TOOLCHAINS_DOC_TS)
# Phony rules to build and clean toolchains easily
toolchains: $(TOOLCHAINS)
$(TOOLCHAINS): %: $(BUILDDIR)/%
clean-toolchains:
docker rmi $(TOOLCHAINS)
rm -f $(TOOLCHAINS_TS)
$(TOOLCHAINS): %: $(BUILDDIR)/%
.PHONY: toolchains clean-toolchains $(TOOLCHAINS)
# Raw Dockerfile toolchains are just built using docker
# They generate a timestamp file in $(BUILDDIR)
$(TOOLCHAINS_DOC_TS): $(BUILDDIR)/%: %/Dockerfile
@echo "Building $*"
docker build -t $* -f $< $(<D)
touch "$@"
# m4 Dockerfile toolchains are preprocessed using GNU m4 before being built by docker
# m4 include path is toolchains/m4 and directory of the toolchain
# toolchains/m4/library.m4 is automatically included at start for common functions
# Using VERBOSE=1 makes rule generate a Dockerfile.debug file with preprocessed content and optional trace (m4_traceon instruction)
# They generate a timestamp file in $(BUILDDIR)
$(TOOLCHAINS_M4_TS): $(BUILDDIR)/%: %/Dockerfile.m4 $(shell find toolchains/m4 -type f)
@echo "Building $*"
ifeq ($(VERBOSE),1)
@@ -74,36 +104,52 @@ endif
docker build -t $* -f - $(<D)
touch "$@"
$(foreach i,$(TOOLCHAINS),$(eval $(call MAKE_DEPS,$(i))))
$(foreach i,$(TOOLCHAINS),$(eval $(call DEPEND_COMMON,$(i))))
# Add here all dependencies between toolchains
$(BUILDDIR)/toolchains/devkit3ds: $(BUILDDIR)/toolchains/devkitarm
$(BUILDDIR)/toolchains/devkitnds: $(BUILDDIR)/toolchains/devkitarm
# Specific toolchains interdependencies
$(BUILDDIR)/toolchains/android: $(BUILDDIR)/toolchains/android-common
$(BUILDDIR)/toolchains/android-old: $(BUILDDIR)/toolchains/android-common
$(BUILDDIR)/toolchains/devkit3ds: $(BUILDDIR)/toolchains/devkitarm
$(BUILDDIR)/toolchains/devkitnds: $(BUILDDIR)/toolchains/devkitarm
clean-toolchains:
docker rmi $(TOOLCHAINS)
rm -f $(TOOLCHAINS_TS)
# Generate dependencies over files and common toolchain
$(foreach i,$(TOOLCHAINS), \
$(eval $(call MAKE_DEPS,$(i))) \
)
$(foreach i,$(TOOLCHAINS), \
$(eval $(call DEPEND_COMMON,$(i))) \
)
# Workers rules
# List all workers: m4 based and raw Dockerfile based
WORKERS_M4=$(patsubst %/,%,$(dir $(wildcard workers/*/Dockerfile.m4)))
WORKERS_DOC=$(patsubst %/,%,$(dir $(wildcard workers/*/Dockerfile)))
WORKERS=$(WORKERS_M4) $(WORKERS_DOC)
# Build timestamps files generated as a marker
WORKERS_M4_TS=$(foreach i,$(WORKERS_M4),$(BUILDDIR)/$(i))
WORKERS_DOC_TS=$(foreach i,$(WORKERS_DOC),$(BUILDDIR)/$(i))
WORKERS_TS=$(WORKERS_M4_TS) $(WORKERS_DOC_TS)
# Phony rules to build and clean workers easily
workers: $(WORKERS)
$(WORKERS): %: $(BUILDDIR)/%
clean-workers:
docker rmi $(WORKERS)
rm -f $(WORKERS_TS)
$(WORKERS): %: $(BUILDDIR)/%
.PHONY: workers $(WORKERS) clean-workers
# Raw Dockerfile workers are just built using docker
# They generate a timestamp file in $(BUILDDIR)
$(WORKERS_DOC_TS): $(BUILDDIR)/%: %/Dockerfile
@echo "Building $*"
docker build --build-arg BUILDBOT_VERSION=$(BUILDBOT_VERSION) -t $@ -f $< $(<D)
touch "$@"
# m4 Dockerfile workers are preprocessed using GNU m4 before being built by docker
# m4 include path is workers/m4 and directory of the worker
# workers/m4/library.m4 is automatically included at start for common functions
# Using VERBOSE=1 makes rule generate a Dockerfile.debug file with preprocessed content and optional trace (m4_traceon instruction)
# They generate a timestamp file in $(BUILDDIR)
$(WORKERS_M4_TS): $(BUILDDIR)/%: %/Dockerfile.m4 $(shell find workers/m4 -type f)
@echo "Building $*"
ifeq ($(VERBOSE),1)
@@ -113,11 +159,10 @@ endif
docker build --build-arg BUILDBOT_VERSION=$(BUILDBOT_VERSION) -t $* -f - $(<D)
touch "$@"
$(foreach i,$(WORKERS),$(eval $(call MAKE_DEPS,$(i))))
$(foreach i,$(WORKERS),$(eval $(call DEPEND_TOOLCHAIN,$(i))))
clean-workers:
docker rmi $(WORKERS)
rm -f $(WORKERS_TS)
.PHONY: nothing master status toolchains $(TOOLCHAINS) clean-toolchains workers $(WORKERS) clean-workers ccache-stats
# Generate dependencies over files and toolchain of the same name
$(foreach i,$(WORKERS), \
$(eval $(call MAKE_DEPS,$(i))) \
)
$(foreach i,$(WORKERS), \
$(eval $(call DEPEND_TOOLCHAIN,$(i))) \
)