From: Ian Jackson <ijackson@chiark.greenend.org.uk>
Date: Mon, 9 Dec 2019 15:02:26 +0000 (+0000)
Subject: README: v2: Define &:section
X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ian/git?a=commitdiff_plain;h=1fdc5cab6272253a42722e8097e8b6699443c1a6;p=subdirmk.git

README: v2: Define &:section

Not implemented yet.

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

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