arm-trusted-firmware/make_helpers
Chris Kay 7c4e1eea61 build: unify verbosity handling
This change introduces a few helper variables for dealing with verbose
and silent build modes: `silent`, `verbose`, `q` and `s`.

The `silent` and `verbose` variables are boolean values determining
whether the build system has been configured to run silently or
verbosely respectively (i.e. with `--silent` or `V=1`).

These two modes cannot be used together - if `silent` is truthy then
`verbose` is always falsy. As such:

    make --silent V=1

... results in a silent build.

In addition to these boolean variables, we also introduce two new
variables - `s` and `q` - for use in rule recipes to conditionally
suppress the output of commands.

When building silently, `s` expands to a value which disables the
command that follows, and `q` expands to a value which supppresses
echoing of the command:

    $(s)echo 'This command is neither echoed nor executed'
    $(q)echo 'This command is executed but not echoed'

When building verbosely, `s` expands to a value which disables the
command that follows, and `q` expands to nothing:

    $(s)echo 'This command is neither echoed nor executed'
    $(q)echo 'This command is executed and echoed'

In all other cases, both `s` and `q` expand to a value which suppresses
echoing of the command that follows:

    $(s)echo 'This command is executed but not echoed'
    $(q)echo 'This command is executed but not echoed'

The `s` variable is predominantly useful for `echo` commands, where you
always want to suppress echoing of the command itself, whilst `q` is
more useful for all other commands.

Change-Id: I8d8ff6ed714d3cb401946c52955887ed7dca602b
Signed-off-by: Chris Kay <chris.kay@arm.com>
2024-06-14 15:54:48 +00:00
..
tbbr fix(tbbr): unrecognised 'tos-fw-key-cert' option 2023-09-07 11:14:52 +01:00
toolchains build: improve diagnostics for unrecognized toolchain tools 2024-04-29 12:47:01 +00:00
arch_features.mk refactor(mte): remove mte, mte_perm 2024-03-26 14:30:58 -05:00
armv7-a-cpus.mk refactor(build): merge march32/64 directives 2023-06-22 16:37:03 -05:00
build_env.mk build: refactor toolchain detection 2024-02-06 11:14:52 +00:00
build_macros.mk build: unify verbosity handling 2024-06-14 15:54:48 +00:00
common.mk build: unify verbosity handling 2024-06-14 15:54:48 +00:00
cygwin.mk Use SPDX license identifiers 2017-05-03 09:39:28 +01:00
defaults.mk build: unify verbosity handling 2024-06-14 15:54:48 +00:00
march.mk build: skip toolchain detection for some targets 2024-05-14 15:41:15 +00:00
msys.mk Use SPDX license identifiers 2017-05-03 09:39:28 +01:00
plat_helpers.mk Change PLATFORM_ROOT to TF_PLATFORM_ROOT 2018-03-05 14:18:04 +08:00
toolchain.mk build: allow shell commands in CC and friends 2024-05-15 13:33:38 +02:00
unix.mk build: unify verbosity handling 2024-06-14 15:54:48 +00:00
utilities.mk build: add facilities for interpreting boolean values 2024-06-14 15:54:47 +00:00
windows.mk build: unify verbosity handling 2024-06-14 15:54:48 +00:00