[SUBDIRMK RFC 3/7] README: v2: Define &:section

[Ian Jackson]

Not implemented yet.

Signed-off-by: Ian Jackson <ijackson at chiark.greenend.org.uk>
---
 README | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/README b/README
index e2985d0..c6ba8f5 100644
--- 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
-- 
2.11.0