aboutsummaryrefslogtreecommitdiff
path: root/docs/markdown/snippets/deprecate_build_always.md
blob: d6e54b5df6ba650331750f32017bfa5abbd71717 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
## Deprecate `build_always`

Setting `build_always` to `true` for a custom target not only marks the target
to be always considered out of date, but also adds it to the set of default
targets. This option is therefore deprecated and the new option
`build_always_stale` is introduced.

`build_always_stale` *only* marks the target to be always considered out of
date, but does not add it to the set of default targets. The old behaviour can
be achieved by combining `build_always_stale` with `build_by_default`.

The documentation has been updated accordingly.