* doc/make.texi (Phony Targets): [SV 58961] Clarify pattern handling

1 files changed, 6 insertions, 0 deletions

diff --git a/doc/make.texi b/doc/make.texi
index d6fd1d03..62103efb 100644
--- a/doc/make.texi
+++ b/doc/make.texi
@@ -2720,6 +2720,12 @@ clean:
 Once this is done, @samp{make clean} will run the recipe regardless of
 whether there is a file named @file{clean}.
 
+Prerequisites of @code{.PHONY} are always interpreted as literal
+target names, never as patterns (even if they contain @samp{%}
+characters).  To always rebuild a pattern rule consider using a
+``force target'' (@pxref{Force Targets, ,Rules without Recipes or
+Prerequisites}).
+
 Phony targets are also useful in conjunction with recursive
 invocations of @code{make} (@pxref{Recursion, ,Recursive Use of @code{make}}).
 In this situation the makefile will often contain a variable which