github-repos/make
1
0
Fork 0
mirror of https://github.com/mirror/make.git synced 2025-03-27 20:40:35 +08:00
Code Issues Packages Projects Releases Wiki Activity

* doc/make.texi: Update out of date behavior for grouped targets.

Browse Source
This commit is contained in:
Paul Smith 2022-09-25 16:58:36 -04:00
parent 614033f8c6
commit 38116baee9
1 changed files with 14 additions and 14 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

28
doc/make.texi
View File

@ -3307,17 +3307,17 @@ can do it with a @dfn{static pattern rule}. @xref{Static Pattern,
@cindex grouped targets @cindex grouped targets
@cindex targets, grouped @cindex targets, grouped
If instead of independent targets you have a recipe that generates If instead of independent targets you have a recipe that generates multiple
multiple files from a single invocation, you can express that files from a single invocation, you can express that relationship by declaring
relationship by declaring your rule to use @emph{grouped targets}. A your rule to use @emph{grouped targets}. A grouped target rule uses the
grouped target rule uses the separator @code{&:} (the @samp{&} here is separator @code{&:} (the @samp{&} here is used to imply ``all'').
used to imply ``all'').
When @code{make} builds any one of the grouped targets, it understands When @code{make} builds any one of the grouped targets, it understands that
that all the other targets in the group are also created as a result all the other targets in the group are also updated as a result of the
of the invocation of the recipe. Furthermore, if only some of the invocation of the recipe. Furthermore, if only some of the grouped targets
grouped targets are out of date or missing @code{make} will realize are out of date or missing @code{make} will realize that running the recipe
that running the recipe will update all of the targets. will update all of the targets. Finally, if any of the grouped targets are
out of date, all the grouped targets are considered out of date.
As an example, this rule defines a grouped target: As an example, this rule defines a grouped target:
@ -10618,10 +10618,10 @@ More than one pattern rule may match a target. In this case
@cindex multiple targets, in pattern rule @cindex multiple targets, in pattern rule
@cindex target, multiple in pattern rule @cindex target, multiple in pattern rule
Pattern rules may have more than one target; however, every target Pattern rules may have more than one target; however, every target must
must contain a @code{%} character. Pattern rules are always treated contain a @code{%} character. Multiple target patterns in pattern rules are
as grouped targets (@pxref{Multiple Targets, , Multiple Targets in a always treated as grouped targets (@pxref{Multiple Targets, , Multiple Targets
Rule}) regardless of whether they use the @code{:} or @code{&:} in a Rule}) regardless of whether they use the @code{:} or @code{&:}
separator. separator.
@node Pattern Examples, Automatic Variables, Pattern Intro, Pattern Rules @node Pattern Examples, Automatic Variables, Pattern Intro, Pattern Rules