docs: tuple syntax cutover — Tuple(...) type, .(...) value, channel-outside-Tuple failables

Rewrite specs.md tuple/failable/pack/UFCS/grammar sections to the new
syntax, update readme.md, and refresh stale tuple references in example
header comments. Also fixes two pre-existing doc inaccuracies surfaced in
review: drop the value-discarding `;` in the tuple-return examples, and
correct the §13 function-type grammar production (optional param list +
optional trailing `!` channel). Optional semantics unchanged.

current/CHECKPOINT-LANG.md logs the cutover.
This commit is contained in:
agra
2026-06-25 18:41:22 +03:00
parent 1dfc22794e
commit 40b5fb5f7e
17 changed files with 184 additions and 103 deletions

View File

@@ -10,7 +10,7 @@
// - wrapper-alias element `BoxPtr :: *Box` (engine wrapper aliasing)
// - union body-builder child `WrapU :: union { b: Box }` (C1, registerUnionDecl)
// - enum body-builder child `WrapE :: enum { V: Box }` (C1, registerEnumDecl)
// - tuple-literal element `size_of((Box, i32))` (O1/K5)
// - tuple-type element `size_of(Tuple(Box, i32))` (O1/K5)
// - inline-anonymous body child `x : union { b: Box }` (inline-anon engine arm)
//
// Fail-before (pre-E6b-R): each of these resolved `Box` through the stateless