diff options
| author | Danilo M. <danix@danix.xyz> | 2026-09-16 20:05:37 +0200 |
|---|---|---|
| committer | Danilo M. <danix@danix.xyz> | 2026-09-16 20:05:37 +0200 |
| commit | 03d3d2a95b417208499fb1f9f9aeed217260cc2e (patch) | |
| tree | 0b706c98e99f12c6d5b45d4d3e7ef202e3b0dab0 /hypr/README.md | |
| parent | b21deb0c6bfeca1c1af33875d55e7c26c62d0bba (diff) | |
| download | conky-theme-udt-03d3d2a95b417208499fb1f9f9aeed217260cc2e.tar.gz conky-theme-udt-03d3d2a95b417208499fb1f9f9aeed217260cc2e.zip | |
docs: fix the toggle syntax and verify the unusual rule keys
Four defects, all found while running Task 8.
The documented toggle command does not work on this machine. Under the
Lua config `hyprctl dispatch` evaluates its argument as Lua, so the
plain `hyprctl dispatch togglespecialworkspace dash` fails with "')'
expected near 'dash'"; Hyprland even says so in its error. The working
form is `hyprctl dispatch 'hl.dsp.workspace.toggle_special("dash")'`,
verified toggling special:dash on and off. Also read the result from
`monitors[0].specialWorkspace.name`, since activeworkspace keeps
reporting the ordinary workspace underneath.
`fullscreen` and `no_focus` appear in no existing rule, so they were
checked against the runtime rather than left as caveats:
hl.window_rule rejects an unknown field with "unknown field '<name>'",
and neither produces that error, so both are accepted. A deliberate
bogus key confirmed the check itself works.
hl.mainMod is nil in any section other than keybindings.lua, which
declares `local mainMod = "SUPER"` and never exports it. The plan
hedged about this; it now states the literal to use.
Task 8's class check ran `conky -c ./conky.conf`, which is gitignored
generated output and absent on a fresh clone, so it now renders the
config first. Its `pkill -f` also matched the running script's own
command line and killed the shell's process group, returning 144 and
swallowing the log it had just been told to read; `pkill -x conky`
instead, fixed in Tasks 4 and 6 too.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Diffstat (limited to 'hypr/README.md')
| -rw-r--r-- | hypr/README.md | 25 |
1 files changed, 20 insertions, 5 deletions
diff --git a/hypr/README.md b/hypr/README.md index 90a5f4d..8e81bdc 100644 --- a/hypr/README.md +++ b/hypr/README.md @@ -32,8 +32,23 @@ other sections. ## Rule keys `workspace`, `float`, `border_size` and `rounding` are all used by existing -rules in `sections/look_and_feel.lua` and `sections/workspaces.lua`, so their -spelling is confirmed. `fullscreen` and `no_focus` are not used anywhere else -in this config; if the Lua runtime ignores them, the dashboard still lands on -`special:dash` and can be sized with -`size = "(monitor_w) (monitor_h)"` instead. +rules in `sections/look_and_feel.lua` and `sections/workspaces.lua`. +`fullscreen` and `no_focus` are used nowhere else in this config, so they were +checked against the runtime instead: `hl.window_rule` rejects an unknown field +with `unknown field '<name>'`, and neither of these produces that error, so the +Lua API accepts both. + +## Testing the toggle by hand + +Under the Lua config, `hyprctl dispatch` evaluates its argument as Lua, so the +plain Hyprland syntax does not work: + + # wrong: ')' expected near 'dash' + hyprctl dispatch togglespecialworkspace dash + + # right + hyprctl dispatch 'hl.dsp.workspace.toggle_special("dash")' + +Check which special workspace is showing with: + + hyprctl monitors -j | jq -r '.[0].specialWorkspace.name' |
