Docs: drop while/|x| drift from runtime+lowering READMEs; correct status #20

Manually merged
dferreira merged 1 commit from feat/020-docs-drop-while-x-drift-from-runtime-lowering into master 2026-01-22 14:43:12 +01:00
Owner

Docs: drop while/|x| drift from runtime+lowering READMEs; correct status

Along the way:

  • docs: drop while/|x| drift from runtime+lowering READMEs; correct status

Touches 3 files: README.md, docs/impl/lowering/README.md, docs/impl/runtime/README.md.

Docs: drop while/|x| drift from runtime+lowering READMEs; correct status Along the way: - docs: drop while/|x| drift from runtime+lowering READMEs; correct status Touches 3 files: `README.md`, `docs/impl/lowering/README.md`, `docs/impl/runtime/README.md`.
dferreira approved these changes 2026-01-22 13:36:07 +01:00
dferreira left a comment

A clear improvement. The change in docs/impl/runtime/README.md is the part I would have argued for.

A clear improvement. The change in `docs/impl/runtime/README.md` is the part I would have argued for.
@ -54,3 +54,3 @@
| Order | Slice | Spec | What it lands | Gating fixture | Status |
|---|---|---|---|---|---|
| **7** | Bindings & control flow | [R2-bindings-control-flow.md](R2-bindings-control-flow.md) | `let`, blocks, `if`/`else`, `while`, `for`, `match` (decision tree in Floor IR), ranges as values | a `match`/`for` test computes the expected value | ⬜ |
| **7** | Bindings & control flow | [R2-bindings-control-flow.md](R2-bindings-control-flow.md) | `let`, blocks, `if`/`else`, `for` (the one loop primitive per [syntax.md](../../syntax.md#loops)), `match` (decision tree in Floor IR), ranges as values | a `match`/`for` test computes the expected value | ⬜ |
Owner

I had to read Bindings twice. Nothing wrong with it, but one line of comment would save the next person the second read.

I had to read `Bindings` twice. Nothing wrong with it, but one line of comment would save the next person the second read.
Author
Owner

Comment added on Bindings in docs/impl/runtime/README.md. It was obvious when I wrote it and it will not be in a month.

Comment added on `Bindings` in `docs/impl/runtime/README.md`. It was obvious when I wrote it and it will not be in a month.
CkLang v0 has one loop primitive (`for`); `while`/`loop` are not in the
grammar, and `|` is not a lambda delimiter. The runtime and lowering
READMEs still referenced them, and the lowering README's later-slice
list lagged the runtime-side R-renumber. The root README's status
section also overstated the bootstrap (claimed type-check / effects /
runtime were implemented, when only lex / parse / module-load /
name-resolve are landed).

- runtime/README: R1–R13 → R1–R12 (only 12 R-files exist); R2 row
  drops `while`, points at syntax.md#loops.
- lowering/README: closure desugaring uses `(x: T) => body`; `for`
  desugaring describes a Floor IR loop primitive instead of Rust-ish
  `while let Some(x) = it.next()`; pass-through list drops `while`;
  later-slice numbering R3/R4/R5/R6 → R2/R3/R4/R5.
- README (root): status reflects what is actually landed and points at
  the runtime cascade as the next work.
dferreira manually merged commit c7fac8d61b into master 2026-01-22 14:43:12 +01:00
Sign in to join this conversation.
No reviewers
No labels
No milestone
No project
No assignees
2 participants
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
northgale/cklang-bootstrap!20
No description provided.