tests: a capture is a delta and a click names its word, so a tagline edit stops rewriting the suite

1 files changed, 7 insertions, 4 deletions

diff --git a/test/macos_e2e.swift b/test/macos_e2e.swift
index f1bad492..c076aebb 100644
--- a/test/macos_e2e.swift
+++ b/test/macos_e2e.swift
@@ -13,10 +13,13 @@
 // entry points the NSEvent overrides call. What a script exercises is what a
 // hand exercises.
 //
-// The output format is test/snapshot.zig's, deliberately byte-identical in
-// shape (`== snap <label> grid=CxR cursor=X,Y` then one `|`-prefixed row each,
-// right-trimmed), and the shared command spellings — wait, stable, text, key,
-// resize, snap — are its as well. Three shells render one core; a capture that
+// The output format is test/snapshot.zig's header and row spelling (`== snap
+// <label> grid=CxR cursor=X,Y` then one `|`-prefixed row each, right-trimmed),
+// and the shared command spellings — wait, stable, text, key, resize, snap —
+// are its as well. Every capture here is a WHOLE frame: the tty runner emits
+// later captures as row deltas (`|<n>: <row>`, see its Prev), which this suite
+// does not, so the goldens are comparable row for row but not file for file.
+// Three shells render one core; a capture that
 // cannot be read beside the other two backends' captures is worth much less.
 //
 // The hermetic world under /tmp/pardes-macos-e2e is not optional. A golden