Remove spec §N.N citations from comments, keep them self-contained

Comments citing the spec document instead of just stating the fact
directly made their usefulness depend on cross-referencing a separate
file. Reworded each one to stand alone - same content, citation dropped,
folded into a normal sentence where it was mid-clause rather than
trailing. spec/porthole-spec.md itself is untouched.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
This commit is contained in:
2026-08-14 12:32:56 +02:00
parent 3d927e25d1
commit 40437bf78c
11 changed files with 39 additions and 40 deletions

View File

@@ -34,7 +34,7 @@
# ~/.config/porthole or ~/.local/state/porthole.
# - Every profile created is named "$NAME_..." (default prefix
# porttestsuite); no operation targets anything outside that prefix.
# - `wipe` (spec §5.8 / src/commands/wipe.rs) kills ANY process on the
# - `wipe` (src/commands/wipe.rs) kills ANY process on the
# whole system whose cmdline contains "__supervise", regardless of
# which state dir it belongs to - it is NOT scoped by the sandboxing
# above. Before running it, this script scans the real process table