no-mistakes(document): Clarify config documentation
- commit
- 1ef1be55d7e572660c9754a02f4926b3da24e9c2
- author
- brice · · 2026-07-05 20:33 UTC
- parent
- 6962e05
- signature
- GPG Verified
CD88F9E564E0102646FB6077A1A07C7C7C3E349D· arch-gpg Verified for the committer email
1 file · +4 -4
M README.md +4 -4
| @@ -40,10 +40,10 @@ Only one client is attached to a session at a time; attaching again displaces th | |||
| 40 | 40 | ||
| 41 | 41 | ## Configuration | |
| 42 | 42 | ||
| 43 | - | vev reads `$XDG_CONFIG_HOME/vev/config`, or `~/.config/vev/config` when `XDG_CONFIG_HOME` is unset. The daemon reloads it while running. | |
| 43 | + | vev reads `$XDG_CONFIG_HOME/vev/config`, or `~/.config/vev/config` when `XDG_CONFIG_HOME` is unset. Missing files use defaults. The daemon reloads mtime/size changes while running, polling about every two seconds. | |
| 44 | 44 | ||
| 45 | 45 | ```text | |
| 46 | - | # Theme: auto, dark, or light. | |
| 46 | + | # Theme: auto follows the client; dark/light force built-in palettes. | |
| 47 | 47 | theme = auto | |
| 48 | 48 | ||
| 49 | 49 | # Rebindable actions. Leave a line out to keep its built-in binding. | |
| @@ -63,7 +63,7 @@ switch-tab-7 = alt+7 | |||
| 63 | 63 | switch-tab-8 = alt+8 | |
| 64 | 64 | switch-tab-9 = alt+9 | |
| 65 | 65 | ||
| 66 | - | # Command palette codes: 2-3 uppercase letters or digits. | |
| 66 | + | # Command palette codes are trimmed, uppercased, then checked as 2-3 letters or digits. | |
| 67 | 67 | code.new-tab = CNT | |
| 68 | 68 | code.new-session = CNS | |
| 69 | 69 | code.close-tab = CLT | |
| @@ -90,7 +90,7 @@ code.detach = DET | |||
| 90 | 90 | ||
| 91 | 91 | Configuring an action replaces all of its built-in aliases. In the example above, the focus-pane lines keep Alt+h/j/k/l but not the Alt+Arrow aliases; omit those lines to keep all built-ins. | |
| 92 | 92 | ||
| 93 | - | Key specs support `alt+<char>`, `alt+space`, and `alt+left/right/up/down`; digit key specs support `alt+1` through `alt+9`, not `alt+0`. `jump-attention` first opens the oldest attention tab in the current session; if none exists, it opens the oldest attention tab in another session. Invalid entries are logged as warnings and skipped where possible. | |
| 93 | + | Key specs support `alt+<char>`, `alt+space`, and `alt+left/right/up/down`; digit key specs support `alt+1` through `alt+9`, not `alt+0`. `jump-attention` first opens the oldest attention tab in the current session; if none exists, it opens the oldest attention tab in another session. Invalid entries are logged as warnings and skipped where possible; duplicate config keys use the last value, binding conflicts keep the later action's defaults, and command-code conflicts drop the conflicting override. | |
| 94 | 94 | ||
| 95 | 95 | ## Remote attach | |
| 96 | 96 | ||
| @@ -40,10 +40,10 @@ Only one client is attached to a session at a time; attaching again displaces th | |||||
| 40 | 40 | ||||
| 41 | ## Configuration | 41 | ## Configuration | ||
| 42 | 42 | ||||
| 43 | - | vev reads `$XDG_CONFIG_HOME/vev/config`, or `~/.config/vev/config` when `XDG_CONFIG_HOME` is unset. The daemon reloads it while running. | 43 | + | vev reads `$XDG_CONFIG_HOME/vev/config`, or `~/.config/vev/config` when `XDG_CONFIG_HOME` is unset. Missing files use defaults. The daemon reloads mtime/size changes while running, polling about every two seconds. |
| 44 | 44 | ||||
| 45 | ```text | 45 | ```text | ||
| 46 | - | # Theme: auto, dark, or light. | 46 | + | # Theme: auto follows the client; dark/light force built-in palettes. |
| 47 | theme = auto | 47 | theme = auto | ||
| 48 | 48 | ||||
| 49 | # Rebindable actions. Leave a line out to keep its built-in binding. | 49 | # Rebindable actions. Leave a line out to keep its built-in binding. | ||
| @@ -63,7 +63,7 @@ switch-tab-7 = alt+7 | |||||
| 63 | switch-tab-8 = alt+8 | 63 | switch-tab-8 = alt+8 | ||
| 64 | switch-tab-9 = alt+9 | 64 | switch-tab-9 = alt+9 | ||
| 65 | 65 | ||||
| 66 | - | # Command palette codes: 2-3 uppercase letters or digits. | 66 | + | # Command palette codes are trimmed, uppercased, then checked as 2-3 letters or digits. |
| 67 | code.new-tab = CNT | 67 | code.new-tab = CNT | ||
| 68 | code.new-session = CNS | 68 | code.new-session = CNS | ||
| 69 | code.close-tab = CLT | 69 | code.close-tab = CLT | ||
| @@ -90,7 +90,7 @@ code.detach = DET | |||||
| 90 | 90 | ||||
| 91 | Configuring an action replaces all of its built-in aliases. In the example above, the focus-pane lines keep Alt+h/j/k/l but not the Alt+Arrow aliases; omit those lines to keep all built-ins. | 91 | Configuring an action replaces all of its built-in aliases. In the example above, the focus-pane lines keep Alt+h/j/k/l but not the Alt+Arrow aliases; omit those lines to keep all built-ins. | ||
| 92 | 92 | ||||
| 93 | - | Key specs support `alt+<char>`, `alt+space`, and `alt+left/right/up/down`; digit key specs support `alt+1` through `alt+9`, not `alt+0`. `jump-attention` first opens the oldest attention tab in the current session; if none exists, it opens the oldest attention tab in another session. Invalid entries are logged as warnings and skipped where possible. | 93 | + | Key specs support `alt+<char>`, `alt+space`, and `alt+left/right/up/down`; digit key specs support `alt+1` through `alt+9`, not `alt+0`. `jump-attention` first opens the oldest attention tab in the current session; if none exists, it opens the oldest attention tab in another session. Invalid entries are logged as warnings and skipped where possible; duplicate config keys use the last value, binding conflicts keep the later action's defaults, and command-code conflicts drop the conflicting override. |
| 94 | 94 | ||||
| 95 | ## Remote attach | 95 | ## Remote attach | ||
| 96 | 96 | ||||