X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ian/git?a=blobdiff_plain;f=README;h=0b84a0ec35dcfd6aec0c08736bd3f9b028b25b91;hb=faea3b5420ab60445e8efb82940fac474a441de1;hp=a44fb492b47301ea3bbbef8c102c645c5e4c9f8c;hpb=02276fc4ac88fc9cd85625c749ffe4305a8a69f8;p=subdirmk.git

diff --git a/README b/README
index a44fb49..0b84a0e 100644
--- a/README
+++ b/README
@@ -88,13 +88,13 @@ empty string).
 
 &=		=>	sub_dir				or TOP
 
-&^lc		=>	$(top_srcdir)/sub/dir/lc
-&^/		=>	$(top_srcdir)/sub/dir/
-&^.		=>	$(top_srcdir)/sub/dir
+&^lc		=>	${top_srcdir}/sub/dir/lc
+&^/		=>	${top_srcdir}/sub/dir/
+&^.		=>	${top_srcdir}/sub/dir
 
-&~lc		=>	$(top_srcdir)/lc
-&~/		=>	$(top_srcdir)/
-&~.		=>	$(top_srcdir)
+&~lc		=>	${top_srcdir}/lc
+&~/		=>	${top_srcdir}/
+&~.		=>	${top_srcdir}
 
 In general:
     ^   pathname of this subdirectory in source tree
@@ -114,7 +114,7 @@ So pathname syntax is a subset of:
 &\$		=>	$		provided for $-doubling regimes
 &\NEWLINE				eats the newline and vanishes
 
-&$VARIABLE	=>	$(sub_dir_VARIABLE)	or $(TOP_VARIABLE)
+&$VARIABLE	=>	${sub_dir_VARIABLE}	or ${TOP_VARIABLE}
 	VARIABLE is ASCII starting with a letter and matching \w+
 
 & thing thing... &
@@ -233,8 +233,8 @@ $	=>	$$	including $'s produced by other
 			 &-expansions not mentioned here
 
 &\$	=>	$
-&$NN	=>	$(NN)	where N are digits
 &$(	=>	$(
+&$NN	=>	$(NN)	where N are digits
 
 A few contexts do not support $-doubling, such as directive arguments
 or places where this might imply $-quadrupling.  (There is no way to
@@ -334,7 +334,12 @@ suppressed with the &:warn directive.  The warning tags are:
 	interpret this as $(F)BAR.  It's normally better to write
 	it this way, at least if the variable expansion is followed
 	by more letters.  Note that &$FOO works differently to
-	raw make: it expands to $(sub_dir_FOO).
+	raw make: it expands to ${sub_dir_FOO}.
+
+    broken-var-ref
+        An attempt at variable expansion looking like $&...
+	You probably expected this to mean $(TOP_F)BAR but it
+	expands to $TOP_FBAR which make thinks means $(T)OP_FBAR.
 
     unknown-warning
 	&:warn was used to try to enable a warning that this version