docs(testing): #132 — judge menu geometry by rendering; "just measure" was the trap
All checks were successful
Check / eval (push) Successful in 4m7s
All checks were successful
Check / eval (push) Successful in 4m7s
The guest's unfaithful rofi geometry was already documented in TESTING.md §5. What was not, and what this closes, is that the bullet's fallback advice — "measure text against the 40% window width instead" — is exactly how #131 stayed wrong for weeks, and my own #131 fix made it stale on top of that (the width is calc( 84ch min 65% ) now). Measuring needs a width and a font, and both are per-theme: text menus render through themes/<slug>/rofi.rasi, where boreal + neon-glass pinned a fixed 620px while the rest used 40%, in fonts from Inter 11 to JetBrainsMono 14. The item measured one combination no theme ships, concluded "only truncates below 1920", and the truncation was live on a 2560 panel. So §5 now says: judge by rendering — hardware, or `rofi -dmenu -theme <the built rasi>` + `hyprctl layers` for the real width — and notes checks.rofi-text-width guards the invariant that makes it fit, never how it looks. Declined the other half (fixing the guest's fontconfig/icon cache): the screenshots are useful as content checks, and a guest that lied convincingly about spacing would be worse than one that obviously cannot. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
@@ -148,9 +148,21 @@ Hyprland's headless backend otherwise aborts in a VM-only zero-output state.
|
||||
- **Menu geometry does not survive the guest**: the rofi picker draws with
|
||||
icons at roughly a quarter of `ui.iconSize` and rows short enough that a
|
||||
6-row root clips its last entry behind a scrollbar (`lines = 8` should
|
||||
fit it). Menu screenshots are evidence for **which rows appear**, never
|
||||
for spacing, icon size or label truncation — measure text against the
|
||||
40% window width instead, or check on hardware (BACKLOG #132).
|
||||
fit it) — the guest's font/icon environment, not a regression. Menu
|
||||
screenshots are evidence for **which rows appear**, never for spacing,
|
||||
icon size or label truncation.
|
||||
**And do not "just measure" instead** — that is how #131 stayed wrong for
|
||||
weeks. Measuring needs a width and a font, and both are per-theme: text
|
||||
menus render through `themes/<slug>/rofi.rasi`, where boreal and
|
||||
neon-glass pinned a fixed `620px` while the rest used `40%`, in fonts from
|
||||
Inter 11 to JetBrainsMono 14. The item measured one combination that no
|
||||
theme actually shipped, concluded "only truncates below 1920", and the
|
||||
truncation was live on a 2560 panel. Since #131 the width is
|
||||
`calc( 84ch min 65% )` — font-relative by design, so the arithmetic is
|
||||
even less predictable from a spec sheet. **Judge it by rendering**: on
|
||||
hardware, or with `rofi -dmenu -theme <the built rasi>` plus
|
||||
`hyprctl layers` for the real width. `checks.rofi-text-width` guards the
|
||||
invariant that makes it fit; nothing guards how it looks.
|
||||
|
||||
## 6. When something fails
|
||||
|
||||
|
||||
Reference in New Issue
Block a user