docs: Swap rows in syntax table

[subdirmk.git] / README

diff --git a/README b/README
index 0b95b98ff17f75152a7279503bc8139c56f86471..de97486ea09174f267830bc171a4751a8c740a58 100644 (file)
--- a/README
+++ b/README
@@ -138,8 +138,8 @@ 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
----------------------------------------
+Summary of recommended directory reference syntaxes
+---------------------------------------------------
 
 Path construction &-expansions, meanings summary:
 
@@ -158,14 +158,12 @@ multi-word processing.
                                           
   This       lc       &file     &@file          &,file       &@,file
   directory  any      &/file    &@/file         &,/file      &@,/file
-             several  & f g h   &@ f g h        &, f g h     &^, f g h
+             several  & f g h   &@ f g h        &, f g h     &@, f g h
 
   Top        lc                 &.file          &;file       &@;file
   level      any      file      &./file         &;/file      &@;/file
-             .mk.in   file      $(abs)/file     $(src)/file  $(abs_src)/file
              several  f g h     &. f g h        &; f g h     &@; f g h
-                                &@. file
-                                &@. f g h
+             .mk.in   file      $(abs)/file     $(src)/file  $(abs_src)/file
 
 Substitution syntax
 -------------------
@@ -192,8 +190,9 @@ empty string).
        variables usually uppercase.  Otherwise, use another syntax:
 
 &_             =>      sub_dir_                        or TOP_
-&/             =>      sub/dir/                        or nothing
 &=_            =>      sub_dir                         or TOP
+
+&/             =>      sub/dir/                        or nothing
 &=/            =>      sub/dir                         or .
 &^             =>      $(top_srcdir)/sub/dir           or $(top_srcdir)
 &~             =>      $(abs_top_srcdir)/sub/dir       or $(abs_top_srcdir)