[src/trunk]: src/usr.bin/make/unit-tests make(1): document the interesting pa...

[rillig <rillig%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/b745944ad977
branches:  trunk
changeset: 942011:b745944ad977
user:      rillig <rillig%NetBSD.org@localhost>
date:      Tue Nov 03 17:59:27 2020 +0000

description:
make(1): document the interesting part of the test forsubst.mk

diffstat:

 usr.bin/make/unit-tests/forsubst.mk |  14 +++++++++++++-
 1 files changed, 13 insertions(+), 1 deletions(-)

diffs (21 lines):

diff -r 7fa30f5e8c31 -r b745944ad977 usr.bin/make/unit-tests/forsubst.mk
--- a/usr.bin/make/unit-tests/forsubst.mk       Tue Nov 03 17:38:45 2020 +0000
+++ b/usr.bin/make/unit-tests/forsubst.mk       Tue Nov 03 17:59:27 2020 +0000
@@ -1,4 +1,16 @@
-# $NetBSD: forsubst.mk,v 1.2 2020/10/24 08:34:59 rillig Exp $
+# $NetBSD: forsubst.mk,v 1.3 2020/11/03 17:59:27 rillig Exp $
+#
+# The parser used to break dependency lines at ';' without regard for
+# substitution patterns.  Back then, the first ';' was interpreted as the
+# separator between the dependency and its commands.  This (perhaps coupled
+# with the new handling of .for variables in ${:U<value>...) caused
+# interesting results for lines like:
+#
+# .for file in ${LIST}
+#   for-subst:       ${file:S;^;${here}/;g}
+# .endfor
+#
+# See the commit to unit-tests/forsubst (without the .mk) from 2009-10-07.
 
 all: for-subst