# @ECLASS-VARIABLE: MULTILIB_PARALLEL_PHASES

# @DEFAULT-UNSET

# @DESCRIPTION:

# multilib-minimal.eclass consumers may set this to a string containing

# a space-separated list of phase-function names, like so:

#

# @CODE@

# MULTILIB_PARALLEL_PHASES="src_configure src_test"

# @CODE@

#

# For each (supported) phase-function name in the list, the corresponding

# multilib-minimal_<phase> phase function will execute in parallel, in

# the sense that, within limits (set by multiprocessing.eclass) the

# multilib_<phase> function invocations (or, if none is present, the

# built-in default implementation) for each ABI will run simultaneously.

#

# Any phase-function-names not specified are executed serially, with the

# native ABI coming last.

#

# It is OK to add extra "bonus" whitespace or duplicated values.

# Changes take effect immediately, so it may be set before or after

# inheriting multilib-minimal, or even during execution of a phase function

# (but not in parallelized multilib_<phase> functions; see below).

#

# By default, MULTILIB_PARALLEL_PHASES is empty.  Consuming eclasses could

# override this default by setting a new default before the inherits clause.

# For example,

#

# @CODE

# : {MULTILIB_PARALLEL_PHASES:="src_configure"}

# inherit multilib-minimal

# @CODE

#

# would create a default behavior of parallel src_configure.  The question

# of whether, in practice, eclasses ever should do so is potentially

# complicated; you'll have to figure that out for yourself.

#

# Supported phase-function-names are: src_configure, src_compile, and src_test.

# All other values are silently ignored.

#

# Note that parallel execution can lead to ugly -- and sometimes very, very ugly --

# console output at build-time.  Consumers of multilib-minimal.eclass

# may wish to consider activating less verbose build-time output modes, if they are

# readily available, to mitigate this effect, although doing so goes against a

# long-standing Gentoo tradition and might make debugging a hassle for bugzilla

# and IRC participants, so use your best judgement.

#

# A handy per-ABI log is kept in ${T}/build-${ABI}.log by multibuild.eclass.

# Debugging and bug-reporting may also benefit (unless your bug specifically

# pertains to parallelization) from setting MAKEOPTS=-j1, which will prevent

# parallelization entirely.