X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ian/git?p=subdirmk.git;a=blobdiff_plain;f=NOTES;h=5d57e99ecb2dcab936010d4734727b16e431dc67;hp=b2023817f2beb3c80a9cab908a9623f60bf58fff;hb=abebbc0bd8eca219fe7c48f3a8a445c5a515a275;hpb=4eac60b2aeaba0ff660fd9f58fcdce210592bac0;ds=sidebyside

diff --git a/NOTES b/NOTES
index b202381..5d57e99 100644
--- a/NOTES
+++ b/NOTES
@@ -1,20 +1,30 @@
-&=		=>	subdir
-&_		=>	subdir_
-&/		=>	subdir/
-&CAPS		=>	subdir_CAPS
-&lc		=>	subdir/lc
+&CAPS		=>	subdir_CAPS  			or TOP_CAPS
+&lc		=>	subdir/lc    			or lc
 
-&.= &._ &./ &.CAPS &.lc	=>	$(top_srcdir)/subdir
-&:= &:_ &:/ &:CAPS &:lc	=>	$(abs_top_srcdir)/subdir
-& thing thing		=>	like &thing &thing (until EOL)
+&_		=>	subdir_				or TOP_
+&/		=>	subdir/				or nothing
+&=_		=>	subdir				or TOP
+&=/		=>	subdir				or .
+&^		=>	$(top_srcdir)/subdir		or $(top_srcdir)
+&~		=>	$(abs_top_srcdir)/subdir	or $(abs_top_srcdir)
 
-&&		=>	&
+&&		=>	&&
+\&		=>	&
 
-&! spc		disables & *until* EOL
+& thing thing... &	=>	each thing prefixed by &/ &^ &~ resp
+& ^ thing thing... &		each thing is any non-ws
+& ~ thing thing... &		& may be omitted before EOL or before \EOL
+				other &'s not recognised
+
+CAPS is [A-Z][0-9_A-Z]*(?!\w)
+lc is [a-z][-+,0-9_a-z]*(?!\w)
+
+&!<spaces or tabs>	disables & *until* EOL (and disappears)
 
 &!STUFF		STUFF is recognised instead of & (beyond EOL)
-		STUFF is either all punct or all alphanum (incl _)
+		STUFF is either all ASCII punct or all ASCII alphanum (incl _)
 		any lwsp after STUFF is discarded too
+
 eg notably
  STUFF!&		now & is recognised instead (ie back to normal)
  STUFFSTUFF	STUFF
@@ -22,3 +32,9 @@ eg notably
 eg
  &!@@@		@@@ is recognised instead of &
  @@@!&		go back to &
+
+&TARGETS[_things]		is handled specially
+				must be spelled precisely this way
+				if no _things, means _all
+
+Also, `all' is weird in that it is present even if not specified