Skip to content

The compositor configuration's, the zone-border patch's and the chrome's comments are shorter, with their reasons kept - #254

Merged
DevomB merged 2 commits into
mainfrom
comments-desktop-chrome
Oct 9, 2026
Merged

DevomB merged 2 commits into
mainfrom
comments-desktop-chrome

Conversation

@DevomB

@DevomB DevomB commented Oct 9, 2026

Copy link
Copy Markdown
Owner

Part of the cleanup-held redo, after #241-#248 and #252: the files #191 held. Comments only in build/desktop/dwl-config.h, tools/desktop/dwl-zone-borders.py and tools/desktop/kryptik-chrome, and prose in docs/architecture.md. gui-check.sh, wlprobe.c and gui-test.sh wait for #253, which changes them.

How it was done. The same procedure as #242. Cleanup-held's change was merged onto main, and only regions where every changed line is a comment were kept. Each cut was then read by hand. Stripping comments from main's version and this one gives the same code in all three files. sh -n passes on the chrome, and the patch script still parses. Every changed line in dwl-zone-borders.py is a Python comment between edits, never text inside the C it writes into dwl.c.

Kept from the cut: the patch script's edit comments without their numbers ((1) to (8); the cut dropped six, and this drops the other two). The chrome's notes on the zone files, havoc's arguments, the focus.zone record, --ask, the clock question and the code's three comments. architecture.md's broker paragraph in shorter sentences, and one rewrap.

Kept from main, or rewritten to keep a reason the cut dropped:

  • dwl-config.h's header: a border's colour comes from the kryptik.<zone>. app_id prefix the proxy stamps, and focus never changes it. The commands comment keeps why the menu runs in havoc (a text program in a zone 0 terminal of its own).
  • kryptik-chrome's header: --prompt is where kryptik-launch hands over when it has no terminal. Passphrases reach the daemon as a descriptor, never argv or the environment, and the prompt's comment says so again.
  • The consent watcher: the kernel drops the lock with the subshell, a second session's watcher exits quietly, and confirm windows close fd 9 so they never hold it. set -C means writes never follow a link, not only never clobber.
  • The confirm window drops typed-ahead keys because a hostile zone's may be among them, half-typed lines included.
  • The header's first line stays: the cut's version repeats the paragraph below it.

Dropped from the cut: both of architecture.md's conflicting passages, where main now describes #191's fullscreen bar. "Only the user, with a watch, can say."

How the run proves it. CI's compositor tests build the patched dwl and the fixture suites run the chrome's helpers. Nothing else changes.

DevomB added 2 commits October 8, 2026 19:04
…e's comments are shorter, with their reasons kept: cleanup-held's cut of dwl-config.h, dwl-zone-borders.py, kryptik-chrome and docs/architecture.md, redone on main by hand, comments only

Only comment regions are taken from 65a6fbb, and the patch script's edit
comments lose their numbers, all eight. Main's text stays where the cut drops
a reason the chrome and compositor rely on: the border colour comes from the
app_id prefix only the proxy stamps; passphrases reach the daemon as a
descriptor, never argv or the environment; the consent window drops keys
because a hostile zone's may be waiting; the watcher's lock goes with its
subshell and a second watcher leaves. architecture.md keeps main's fullscreen
bar, which the cut predates.
… an answer that cannot be written is safe

From a non-author read: the cut lost that consent.rs refuses at once if it
can take watcher.lock shared, and that an unwritten answer is a refusal.
@DevomB
DevomB merged commit f3b79f9 into main Oct 9, 2026
11 checks passed
@DevomB
DevomB deleted the comments-desktop-chrome branch October 9, 2026 02:52
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant