chiark / gitweb /
docs: Summarise directory reference syntaxes
authorIan Jackson <ian.jackson@eu.citrix.com>
Thu, 14 Nov 2019 12:36:23 +0000 (12:36 +0000)
committerIan Jackson <ian.jackson@eu.citrix.com>
Thu, 14 Nov 2019 12:36:23 +0000 (12:36 +0000)
This reveals it to be a bit of a mess.

Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
README

diff --git a/README b/README
index 1111dcb..5897e30 100644 (file)
--- a/README
+++ b/README
@@ -138,6 +138,19 @@ If you `include subdirmk/regen.mk', dependency management and
 automatic regeneration for all of this template substitution, and for
 config.status etc. is done for you.
 
+Summary of directory reference syntaxes
+---------------------------------------
+
+                  In source tree             In build tree
+                  Relative     Absolute      Relative  Absolute
+
+                                             &file     $(abs)/&file
+ This directory   &^/file      &~/file       &/file    $(abs)/&/file
+                  & ^ f g h    & ~ f g h     & f g h
+
+ Top level        $(ts)/file   $(ats)/file   file      $(abs)/file
+                                             f g h
+
 Substitution syntax
 -------------------