README: v2: Define &:section

Not implemented yet.

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

diff --git a/README b/README
index e2985d0860a5b7c7a0c2ebf1a57aa42d87d1f1c8..c6ba8f54e40ffb2e6df41e79b9da15d3d3436093 100644 (file)
--- a/README
+++ b/README
@@ -262,6 +262,19 @@ So pathname syntax is a subset of:
 &:-include filename            tolerate nonexistent file
        filenames are relative to $(top_srcdir)
 
+&:section number [ident]
+       Sections will be read by make in order, first by number
+        and only then by input file (in order passed
+        to generate ie that specified in configure.ac).
+       Number is \d+; order is lexical.
+       Default section number is `5'.
+       Section numbers may not contain only `0'.
+       Section is local to &:include'd files (reset to `5'
+        on entry, restored on return).
+       Ident is [A-Za-z][A-Z0-9a-z/_-]+ and is currently unused,
+        other than appearing in output.  When used, will default
+        to source-relative input file name excluding .sd.mk.
+
 &!<lwsp>       disables & until EOL (and then disappears)
 
 &#     delete everything to end of line