From: Paul Smith <psmith@gnu.org>
Date: Sun, 6 Dec 2020 20:21:23 +0000 (-0500)
Subject: * doc/make.texi (Phony Targets): [SV 58961] Clarify pattern handling
X-Git-Tag: 4.3.90~193
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=a8f4669b23f47dae4d42c3fb2908ff878d1bd294;p=thirdparty%2Fmake.git

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

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