This Source Code Form is subject to the terms of the Mozilla Public

License, v. 2.0. If a copy of the MPL was not distributed with this file,

You can obtain one at http://mozilla.org/MPL/2.0/.

ifndef INCLUDED_RULES_MK include $(topsrcdir)/config/rules.mk endif

The traditional model of directory traversal with make is as follows:

make -C foo

Entering foo

make -C bar

Entering foo/bar

make -C baz

Entering foo/baz

make -C qux

Entering qux

Pseudo derecurse transforms the above into:

make -C foo

make -C foo/bar

make -C foo/baz

make -C qux

ifeq (.,$(DEPTH))

include root.mk

Main rules (export, compile, libs and tools) call recurse_* rules.

This wrapping is only really useful for build status.

$(TIERS):: $(call BUILDSTATUS,TIER_START $@) +$(MAKE) recurse_$@ $(call BUILDSTATUS,TIER_FINISH $@)

Special rule that does install-manifests (cf. Makefile.in) + compile

binaries:: +$(MAKE) recurse_compile

Carefully avoid $(eval) type of rule generation, which makes pymake slower

than necessary.

Get current tier and corresponding subtiers from the data in root.mk.

CURRENT_TIER := $(filter $(foreach tier,$(TIERS),recurse_$(tier) $(tier)-deps),$(MAKECMDGOALS)) ifneq (,$(filter-out 0 1,$(words $(CURRENT_TIER)))) $(error $(CURRENT_TIER) not supported on the same make command line) endif CURRENT_TIER := $(subst recurse_,,$(CURRENT_TIER:-deps=))

The rules here are doing directory traversal, so we don't want further

recursion to happen when running make -C subdir $tier. But some make files

further call make -C something else, and sometimes expect recursion to

happen in that case.

Conveniently, every invocation of make increases MAKELEVEL, so only stop

recursion from happening at current MAKELEVEL + 1.

ifdef CURRENT_TIER ifeq (0,$(MAKELEVEL)) export NO_RECURSE_MAKELEVEL=1 else export NO_RECURSE_MAKELEVEL=$(word $(MAKELEVEL),2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20) endif endif

RECURSE = $(if $(RECURSE_TRACE_ONLY),@echo $2/$1,$(call SUBMAKE,$1,$2))

Use the $(*_dirs) variables available in root.mk

CURRENT_DIRS := $($(CURRENT_TIER)_dirs)

Need a list of compile targets because we can't use pattern rules:

https://savannah.gnu.org/bugs/index.php?42833

Only recurse the paths starting with RECURSE_BASE_DIR when provided.

.PHONY: $(compile_targets) $(syms_targets) $(compile_targets) $(syms_targets): $(if $(filter $(RECURSE_BASE_DIR)%,$@),$(call RECURSE,$(@F),$(@D)))

$(syms_targets): %/syms: %/target

Only hook symbols targets into the main compile graph in automation.

ifdef MOZ_AUTOMATION ifdef MOZ_CRASHREPORTER recurse_compile: $(syms_targets) endif endif

Create a separate rule that depends on every 'syms' target so that

symbols can be dumped on demand locally.

.PHONY: recurse_syms recurse_syms: $(syms_targets)

Ensure dump_syms gets built before any syms targets, all of which depend on it.

ifneq (,$(filter toolkit/crashreporter/google-breakpad/src/tools/%/dump_syms/host,$(compile_targets))) $(syms_targets): $(filter toolkit/crashreporter/google-breakpad/src/tools/%/dump_syms/host,$(compile_targets)) endif

The compile tier has different rules from other tiers.

ifneq ($(CURRENT_TIER),compile)

Recursion rule for all directories traversed for all subtiers in the

current tier.

$(addsuffix /$(CURRENT_TIER),$(CURRENT_DIRS)): %/$(CURRENT_TIER): $(call RECURSE,$(CURRENT_TIER),$*)

.PHONY: $(addsuffix /$(CURRENT_TIER),$(CURRENT_DIRS))

Dummy rules for possibly inexisting dependencies for the above tier targets

$(addsuffix /Makefile,$(CURRENT_DIRS)) $(addsuffix /backend.mk,$(CURRENT_DIRS)):

ifeq ($(CURRENT_TIER),export)

At least build/export requires config/export for buildid, but who knows what

else, so keep this global dependency to make config/export first for now.

$(addsuffix /$(CURRENT_TIER),$(filter-out config,$(CURRENT_DIRS))): config/$(CURRENT_TIER)

The export tier requires nsinstall, which is built from config. So every

subdirectory traversal needs to happen after building nsinstall in config, which

is done with the config/host target. Note the config/host target only exists if

nsinstall is actually built, which it is not on Windows, because we use

nsinstall.py there.

ifdef COMPILE_ENVIRONMENT ifneq (,$(filter config/host, $(compile_targets))) $(addsuffix /$(CURRENT_TIER),$(CURRENT_DIRS)): config/host endif endif endif

endif # ifeq ($(CURRENT_TIER),compile)

else

Don't recurse if MAKELEVEL is NO_RECURSE_MAKELEVEL as defined above

ifeq ($(NO_RECURSE_MAKELEVEL),$(MAKELEVEL))

$(TIERS)::

else

Tier traversal handling

define CREATE_SUBTIER_TRAVERSAL_RULE .PHONY: $(1)

$(1):: $$(SUBMAKEFILES) $$(LOOP_OVER_DIRS)

endef

$(foreach subtier,$(filter-out compile,$(TIERS)),$(eval $(call CREATE_SUBTIER_TRAVERSAL_RULE,$(subtier))))

ifndef TOPLEVEL_BUILD ifdef COMPILE_ENVIRONMENT compile:: @$(MAKE) -C $(DEPTH) compile RECURSE_BASE_DIR=$(relativesrcdir)/ endif # COMPILE_ENVIRONMENT endif

endif # ifeq ($(NO_RECURSE_MAKELEVEL),$(MAKELEVEL))

endif # ifeq (.,$(DEPTH))

recurse: @$(RECURSED_COMMAND) $(LOOP_OVER_DIRS)

ifeq (.,$(DEPTH))

Interdependencies for parallel export.

js/xpconnect/src/export: dom/bindings/export xpcom/xpidl/export accessible/xpcom/export: xpcom/xpidl/export

The widget binding generator code is part of the annotationProcessors.

widget/android/bindings/export: build/annotationProcessors/export

.xpt generation needs the xpidl lex/yacc files

xpcom/xpidl/export: xpcom/idl-parser/xpidl/export

ifdef ENABLE_CLANG_PLUGIN $(filter-out config/host build/unix/stdc++compat/% build/clang-plugin/%,$(compile_targets)): build/clang-plugin/target build/clang-plugin/tests/target build/clang-plugin/tests/target: build/clang-plugin/target endif

Interdependencies that moz.build world don't know about yet for compilation.

Note some others are hardcoded or "guessed" in recursivemake.py and emitter.py

ifeq ($(MOZ_WIDGET_TOOLKIT),gtk3) toolkit/library/target: widget/gtk/mozgtk/gtk3/target endif ifdef MOZ_LDAP_XPCOM ldap/target: security/target mozglue/build/target toolkit/library/target: ldap/target endif endif

Most things are built during compile (target/host), but some things happen during export

Those need to depend on config/export for system wrappers.

$(addprefix build/unix/stdc++compat/,target host) build/clang-plugin/target: config/export