From cc234a66f020256ca2cd2a0a189fda00195bb8f0 Mon Sep 17 00:00:00 2001
From: Abhinav <abhinav.prsai@gmail.com>
Date: Tue, 24 Jun 2025 00:20:36 +0100
Subject: add scratchpads

there are now i3 like scratchpads. all default binds added, mans updated
---
 sxwm.1 | 50 +++++++++++++++++++++++++++++++++++++++++++++-----
 1 file changed, 45 insertions(+), 5 deletions(-)

(limited to 'sxwm.1')

diff --git a/sxwm.1 b/sxwm.1
index fabab4d..889a6ae 100644
--- a/sxwm.1
+++ b/sxwm.1
@@ -13,6 +13,8 @@ sxwm is a lightweight and efficient tiling window manager for X11, designed to b
 .SH FEATURES
 Tiling and floating layouts.
 Nine workspaces with full bar support.
+Scratchpads for instant access to floating windows.
+Native windwo swallowing.
 Live configuration reload without restart.
 Human-friendly configuration file requiring no recompilation.
 DWM-style master-stack layout.
@@ -120,19 +122,28 @@ Keybindings associate key combinations with actions, either running external com
 They follow this syntax:
 
 .TP
-.B bind : modifier + modifier + ... + key : action
+.B bind : modifier + ... + key : action
 
 Modifiers can be mod, shift, ctrl, alt, or super. The key is the final key name (e.g., Return, q, 1, equal, space).
 
 Actions can be either a quoted external command or an internal function name.
 
 .TP
-.B workspace : modifier + modifier + ... + key : move n
+.B workspace : modifier + ... + key : move n
 .TP
-.B workspace : modifier + modifier + ... + key : swap n
+.B workspace : modifier + ... + key : swap n
 
 For workspace switching and moving windows. n is the workspace number (1-9).
 
+.TP
+.B scratchpad : modifier + ... + key : create n
+.TP
+.B scratchpad : modifier + ... + key : toggle n
+.TP
+.B scratchpad : modifier + ... + key : remove n
+
+For scratchpad management. create assigns the focused window to scratchpad n, toggle shows/hides scratchpad n, and remove returns the scratchpad window to normal tiling. n is the scratchpad number (1-5).
+
 Example bindings:
 
 .TP
@@ -151,6 +162,18 @@ Go to workspace 3.
 .B workspace : mod + shift + 5 : swap 5
 Move selected window to workspace 5.
 
+.TP
+.B scratchpad : mod + alt + 1 : create 1
+Assign focused window to scratchpad 1.
+
+.TP
+.B scratchpad : mod + ctrl + 1 : toggle 1
+Show or hide scratchpad 1.
+
+.TP
+.B scratchpad : mod + alt + shift + 1 : remove 1
+Remove window from scratchpad 1 and return to normal tiling.
+
 .SH AVAILABLE FUNCTIONS
 The following internal functions are available for keybindings:
 
@@ -305,6 +328,18 @@ Switch to workspace 1 through 9.
 .B MOD + Shift + 1 to 9
 Move focused window to workspace 1 through 9.
 
+.TP
+.B MOD + Alt + 1 to 4
+Create scratchpad 1 through 4.
+
+.TP
+.B MOD + Ctrl + 1 to 4
+Toggle scratchpad 1 through 4.
+
+.TP
+.B MOD + Alt + Shift + 1 to 4
+Remove scratchpad 1 through 4.
+
 .TP
 .B MOD + j / k
 Focus next or previous window.
@@ -386,9 +421,14 @@ bind : mod + d : "rofi -show drun"
 workspace : mod + 1 : move 1
 workspace : mod + shift + 1 : swap 1
 
+# Scratchpad management
+scratchpad : mod + alt + 1 : create 1
+scratchpad : mod + ctrl + 1 : toggle 1
+scratchpad : mod + alt + shift + 1 : remove 1
+
 # Window swallowing
-can_swallow : Alacritty
-can_be_swallowed : sxiv, mpv, zathura
+can_swallow : "st"
+can_be_swallowed : "sxiv", "mpv", "zathura"
 .fi
 .RE
 
-- 
cgit v1.2.3