]> git.ipfire.org Git - thirdparty/make.git/commitdiff
* doc/make.texi: Update out of date behavior for grouped targets.
authorPaul Smith <psmith@gnu.org>
Sun, 25 Sep 2022 20:58:36 +0000 (16:58 -0400)
committerPaul Smith <psmith@gnu.org>
Sun, 25 Sep 2022 20:58:36 +0000 (16:58 -0400)
doc/make.texi

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