From 22df891893d30e9906d0b14fc3ae5d8e67d500b2 Mon Sep 17 00:00:00 2001
From: Cliff Click <cliffc@acm.org>
Date: Sat, 3 Oct 2026 14:03:48 -0700
Subject: Chapter renumber, and split ch 17

Renumber chapters 10a, 10b, 11, 12, 13, 14 -> 10, 11, 13, 12, [11,14].
Split ch 17 into a 17a and 17b; shuffle around im/mutable syntax to be consistent, and present it more slowly.
THe new immutable syntax is pushed through all later chapters
---
 chapter17a/docs/17-grammar.md | 17 +++++++++++++++++
 chapter17a/docs/Makefile      | 12 ++++++++++++
 2 files changed, 29 insertions(+)
 create mode 100644 chapter17a/docs/17-grammar.md
 create mode 100644 chapter17a/docs/Makefile

(limited to 'chapter17a/docs')

diff --git a/chapter17a/docs/17-grammar.md b/chapter17a/docs/17-grammar.md
new file mode 100644
index 00000000..98aef06c
--- /dev/null
+++ b/chapter17a/docs/17-grammar.md
@@ -0,0 +1,17 @@
+# Chapter 17a grammar additions
+
+The expression and statement forms are those of Chapter 16. Declarations add
+independent access and binding modifiers:
+
+```text
+declaration = type binding ("," binding)* ";"
+binding     = ("!" | "~")? identifier ("=" expression)?
+type        = ("!" | "~")? name suffix*
+suffix      = "?" | "[]" | "[~]"
+```
+
+A prefix qualifier requires a struct reference. It qualifies the named base,
+not enclosing arrays. Each bracket pair qualifies its own array layer. A binding
+modifier applies only to the following name. See the README for defaults and
+constructor initialization rules. `var`, `val`, increments, compound assignments,
+conditional expressions, and `for` loops are introduced in Chapter 17b.
diff --git a/chapter17a/docs/Makefile b/chapter17a/docs/Makefile
new file mode 100644
index 00000000..12659b8f
--- /dev/null
+++ b/chapter17a/docs/Makefile
@@ -0,0 +1,12 @@
+GV := $(wildcard *.gv)
+SVG := $(patsubst %.gv,%.svg,$(GV))
+
+.PHONY: all
+all: $(SVG)
+
+%.svg: %.gv
+	dot -Tsvg $< > $@
+
+.PHONY: clean
+clean:
+	@rm -f $(SVG)
-- 
cgit v1.2.3