Skip to content

Commit cbcd575

Browse files
committed
docs(comments): D-522 drain 3 — macro_transforms.zig de-pointered 101→7
Smell-audited: 1: comment-only sweep per the established D-522 method (subagent pass, mechanically verified zero code-token change); 4 stale comments fixed to code-truth (futureCallFn docstring still claimed the pre-concurrency eager stand-in — future.zig spawns a real OS thread).
1 parent 44d2955 commit cbcd575

3 files changed

Lines changed: 155 additions & 151 deletions

File tree

‎.dev/debt.yaml‎

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -71,6 +71,15 @@ active:
7171
(pointers whose surrounding prose is NOT self-contained) — a different,
7272
judgement-heavier pass; the mechanical stamp category no longer recurs
7373
(this drain is the sweep-then-close of it).
74+
DRAIN 3 (2026-07-14): the worst pointer-density file
75+
src/lang/macro_transforms.zig 101→7 ref lines (subagent pass, method
76+
per drains 1-2): cycle/row/part bookkeeping dropped, section banners
77+
de-numbered, bug narratives kept as self-contained prose, 6 genuine
78+
design-citation anchors kept (ADR-0035/0037/0038/0144/0103/0059);
79+
4 STALE comments fixed to code-truth en route (fn/letfn named-fn
80+
lowering, future's real-OS-thread reality ×2 incl. stm.zig's
81+
futureCallFn docstring, a map->record test comment). Next candidates
82+
by density: diff_test.zig 95, vm.zig 89, print.zig 88.
7483
category: "docs"
7584
quality_floor: "public-ization: comment de-pointer + condense (ADR-0166)"
7685
barrier: |-

0 commit comments

Comments
 (0)