- ^ filenames in source tree rather than build tree
- ~ filenames are absolute rather than relative
- @ filenames do not contain subdir (useful with the above)
+ = return subdir without delimiter (not allowed with `,' `;' `@')
+ , pathname of this subdirectory in source tree
+ ; pathname of top level of source tree
+ . pathname of this directory in build tree, implies absolute pathnames
+ @ absolute pathnames (forbidden with `.', must come first)
+
+So pathname syntax is a subset of:
+ '&' [ '@' ] [ ',' | ';' | '.' ] [ lc | '/' ]
+
+ To avoid incomprehensible .sd.mk files, some combinations are not
+ allowed. For example `&@=./' would mean `$(PWD)/sub/dir' but can
+ be spelled `$(PWD)/&=/', but more normally the trailing / can be
+ tolerated, so use `&@/'.