From 342464d3d13ed7ee6d069c5ef78e0d4f7bfb00fd Mon Sep 17 00:00:00 2001 From: Gerry Hernandez Date: Sun, 15 Mar 2026 20:31:49 -0700 Subject: [PATCH] Update documentation with tag_count config var --- docs/bindings/keys.md | 12 ++++++------ docs/configuration/miscellaneous.md | 4 +++- docs/window-management/rules.md | 4 ++-- 3 files changed, 11 insertions(+), 9 deletions(-) diff --git a/docs/bindings/keys.md b/docs/bindings/keys.md index 64ba64b7..08cab9ad 100644 --- a/docs/bindings/keys.md +++ b/docs/bindings/keys.md @@ -116,20 +116,20 @@ bindr=Super,Super_L,spawn,rofi -show run | Command | Param | Description | | :--- | :--- | :--- | -| `view` | `-1/0/1-9` or `mask [,synctag]` | View tag. `-1` = previous tagset, `0` = all tags, `1-9` = specific tag, mask e.g. `1\|3\|5`. Optional `synctag` (0/1) syncs the action to all monitors. | +| `view` | `-1/0/[1, tag_count]` or `mask [,synctag]` | View tag. `-1` = previous tagset, `0` = all tags, mask e.g. `1\|3\|5`. Optional `synctag` (0/1) syncs the action to all monitors. | | `viewtoleft` | `[synctag]` | View previous tag. Optional `synctag` (0/1) syncs to all monitors. | | `viewtoright` | `[synctag]` | View next tag. Optional `synctag` (0/1) syncs to all monitors. | | `viewtoleft_have_client` | `[synctag]` | View left tag and focus client if present. Optional `synctag` (0/1). | | `viewtoright_have_client` | `[synctag]` | View right tag and focus client if present. Optional `synctag` (0/1). | | `viewcrossmon` | `tag,monitor_spec` | View specified tag on specified monitor. | -| `tag` | `1-9 [,synctag]` | Move window to tag. Optional `synctag` (0/1) syncs to all monitors. | -| `tagsilent` | `1-9` | Move window to tag without focusing it. | +| `tag` | `[1, tag_count] [,synctag]` | Move window to tag. Optional `synctag` (0/1) syncs to all monitors. | +| `tagsilent` | `[1, tag_count]` | Move window to tag without focusing it. | | `tagtoleft` | `[synctag]` | Move window to left tag. Optional `synctag` (0/1). | | `tagtoright` | `[synctag]` | Move window to right tag. Optional `synctag` (0/1). | | `tagcrossmon` | `tag,monitor_spec` | Move window to specified tag on specified monitor. | -| `toggletag` | `0-9` | Toggle tag on window (0 means all tags). | -| `toggleview` | `1-9` | Toggle tag view. | -| `comboview` | `1-9` | View multi tags pressed simultaneously. | +| `toggletag` | `[0, tag_count]` | Toggle tag on window (0 means all tags). | +| `toggleview` | `[1, tag_count]` | Toggle tag view. | +| `comboview` | `[1, tag_count]` | View multi tags pressed simultaneously. | | `focusmon` | `left/right/up/down/monitor_spec` | Focus monitor by direction or [monitor spec](/docs/configuration/monitors#monitor-spec-format). | | `tagmon` | `left/right/up/down/monitor_spec,[keeptag]` | Move window to monitor by direction or [monitor spec](/docs/configuration/monitors#monitor-spec-format). `keeptag` is 0 or 1. | diff --git a/docs/configuration/miscellaneous.md b/docs/configuration/miscellaneous.md index 2e5a1e92..6b695e40 100644 --- a/docs/configuration/miscellaneous.md +++ b/docs/configuration/miscellaneous.md @@ -31,6 +31,7 @@ description: Advanced settings for XWayland, focus behavior, and system integrat | Setting | Default | Description | | :--- | :--- | :--- | +| `tag_count` | `9` | Number of tags/workspaces available. Supports range `[1–32]`. **Requires restart to take effect.** | | `focus_cross_monitor` | `0` | Allow directional focus to cross monitor boundaries. | | `exchange_cross_monitor` | `0` | Allow exchanging clients across monitor boundaries. | | `focus_cross_tag` | `0` | Allow directional focus to cross into other tags. | @@ -48,4 +49,5 @@ description: Advanced settings for XWayland, focus behavior, and system integrat | `no_border_when_single` | `0` | Remove window borders when only one window is visible on the tag. | | `idleinhibit_ignore_visible` | `0` | Allow invisible clients (e.g., background audio players) to inhibit idle. | | `drag_tile_refresh_interval` | `8.0` | Interval (1.0–16.0) to refresh tiled window resize during drag. Too small may cause application lag. | -| `drag_floating_refresh_interval` | `8.0` | Interval (1.0–16.0) to refresh floating window resize during drag. Too small may cause application lag. | \ No newline at end of file +| `drag_floating_refresh_interval` | `8.0` | Interval (1.0–16.0) to refresh floating window resize during drag. Too small may cause application lag. | + diff --git a/docs/window-management/rules.md b/docs/window-management/rules.md index 996c172f..d3e60029 100644 --- a/docs/window-management/rules.md +++ b/docs/window-management/rules.md @@ -45,7 +45,7 @@ windowrule=Parameter:Values,Parameter:Values,appid:Values,title:Values | `offsetx` | integer | -999-999 | X offset from center (%), 100 is the edge of screen with outer gap | | `offsety` | integer | -999-999 | Y offset from center (%), 100 is the edge of screen with outer gap | | `monitor` | string | Any | Assign to monitor by [monitor spec](/docs/configuration/monitors#monitor-spec-format) (name, make, model, or serial) | -| `tags` | integer | 1-9 | Assign to specific tag | +| `tags` | integer | `[1, tag_count]` | Assign to specific tag | | `no_force_center` | integer | `0` / `1` | Window does not force center | | `isnosizehint` | integer | `0` / `1` | Don't use min size and max size for size hints | @@ -172,7 +172,7 @@ tagrule=id:Values,monitor_make:xxx,monitor_model:xxx,Parameter:Values | Parameter | Type | Values | Description | | :--- | :--- | :--- | :--- | -| `id` | integer | 0-9 | Match by tag id, 0 means the ~0 tag | +| `id` | integer | `[1, tag_count]` | Match by tag id, 0 means the ~0 tag | | `monitor_name` | string | monitor name | Match by monitor name | | `monitor_make` | string | monitor make | Match by monitor manufacturer | | `monitor_model` | string | monitor model | Match by monitor model |