diff options
Diffstat (limited to 'dwm.1')
| -rw-r--r-- | dwm.1 | 261 |
1 files changed, 172 insertions, 89 deletions
@@ -5,29 +5,59 @@ dwm \- dynamic window manager .B dwm .RB [ \-v ] .SH DESCRIPTION -dwm is a dynamic window manager for X. It manages windows in tiled, monocle -and floating layouts. Either layout can be applied dynamically, optimising the -environment for the application in use and the task performed. +dwm is a dynamic window manager for X. It manages windows in a +variety of layouts: +.nr PI 1n +.IP \[bu] +floating: windows can be resized and moved freely, a la usual window +managers. +.IP \[bu] +tiled: windows are managed in a master and stacking area. The master +area on the left contains one window by default, and the stacking area +on the right contains all other windows. The number of master area +windows can be adjusted from zero to an arbitrary number. +.IP \[bu] +monocle (normal, centred or floating) + +Normal: all windows are maximised to the screen size. + +Centred: the screen is split into three sections with the master +clients getting the second section and the stacking clients get the +remaining 2 sections to be laid out in. + +Floating: the master clients are placed floating in the centre of the +screen while the remaining stacking clients are placed side by side +vertically. +.IP \[bu] +fibonacci (dwindle and spiral): windows are tiled in a spiralling or +dwindling pattern. + +In the dwindle layout new clients tend towards the bottom left of the +monitor while in the spiral layout clients tend towards the centre +bottom left. +.IP \[bu] +deck: the stacking clients are placed floating on top of each other +such that there are only two partitions of the screen space. +.IP \[bu] +gapless grid: n clients are arranged into a square of ceil(sqrt(n)) +length, where the top left is the latest client opened. .P -In tiled layouts windows are managed in a master and stacking area. The master -area on the left contains one window by default, and the stacking area on the -right contains all other windows. The number of master area windows can be -adjusted from zero to an arbitrary number. In monocle layout all windows are -maximised to the screen size. In floating layout windows can be resized and -moved freely. Dialog windows are always managed floating, regardless of the -layout applied. +Dialog windows are always managed floating, regardless of the layout +applied. .P -Windows are grouped by tags. Each window can be tagged with one or multiple -tags. Selecting certain tags displays all windows with these tags. +Windows are grouped by tags. Each window can be tagged with one or +multiple tags. Selecting certain tags displays all windows with these +tags. .P -Each screen contains a small status bar which displays all available tags, the -layout, the title of the focused window, and the text read from the root window -name property, if the screen is focused. A floating window is indicated with an -empty square and a maximised floating window is indicated with a filled square -before the windows title. The selected tags are indicated with a different -color. The tags of the focused window are indicated with a filled square in the -top left corner. The tags which are applied to one or more windows are -indicated with an empty square in the top left corner. +Each screen contains a small status bar which displays all available +tags, the layout, the title of the focused window, and the text read +from the root window name property, if the screen is focused. A +floating window is indicated with an empty square and a maximised +floating window is indicated with a filled square before the windows +title. The selected tags are indicated with a different color. The +tags of the focused window are indicated with a filled square in the +top left corner. The tags which are applied to one or more windows +are indicated with an empty square in the top left corner. .P dwm draws a small border around windows to indicate the focus state. .SH OPTIONS @@ -39,119 +69,172 @@ prints version information to stderr, then exits. .TP .B X root window name is read and displayed in the status text area. It can be set with the -.BR xsetroot (1) +.BR xsetroot (1). This fork uses dwmblocks to generate system status information. command. +.SS Keyboard commands +Mod is set to Super (the "windows" key). .TP -.B Button1 -click on a tag label to display all windows with that tag, click on the layout -label toggles between tiled and floating layout. +.B Mod\-b +Toggle status bar + .TP -.B Button3 -click on a tag label adds/removes all windows with that tag to/from the view. +.B Mod\-` +Toggle scratchpad terminal (set to +.BR st(1) +) + +.TP +.B Mod\-j +Focus next window + +.TP +.B Mod\-k +Focus previous window + .TP -.B Mod1\-Button1 -click on a tag label applies that tag to the focused window. +.B Mod\-. +Increase gap size + .TP -.B Mod1\-Button3 -click on a tag label adds/removes that tag to/from the focused window. -.SS Keyboard commands +.B Mod\-, +Decrease gap size + .TP -.B Mod1\-Shift\-Return -Start -.BR st(1). +.B Mod\-/ +Toggle gaps + .TP -.B Mod1\-p -Spawn -.BR dmenu(1) -for launching other programs. +.B Mod\-Shift\-/ +Print current gap value (using +.BR notify-send(1) +) + .TP -.B Mod1\-, -Focus previous screen, if any. +.B Mod\-h +Decrease size of master area + .TP -.B Mod1\-. -Focus next screen, if any. +.B Mod\-l +Increase size of master are + .TP -.B Mod1\-Shift\-, -Send focused window to previous screen, if any. +.B Mod\-Control\-. +Decrease number of master clients + .TP -.B Mod1\-Shift\-. -Send focused window to next screen, if any. +.B Mod\-Control\-, +Increase number of master clients + .TP -.B Mod1\-b -Toggles bar on and off. +.B Mod\-Shift\-h +Rotate the stack clockwise but keep focus on the same position. + .TP -.B Mod1\-t -Sets tiled layout. +.B Mod\-Shift\-l +Rotate the stack anticlockwise but keep focus on the same position. + .TP -.B Mod1\-f -Sets floating layout. +.B Mod\-Shift\-k +Rotate the master clients clockwise but keep focus on the same position. + .TP -.B Mod1\-m -Sets monocle layout. +.B Mod\-Shift\-j +Rotate the master clients anticlockwise but keep focus on the same position. + .TP -.B Mod1\-space -Toggles between current and previous layout. +.B Mod\-c +If in stack area, swap currently focused client with master. If in master area, swap currently focused client with top of stack area. + .TP -.B Mod1\-j -Focus next window. +.B Mod\-Shift\-t +Set layout to tiling + .TP -.B Mod1\-k -Focus previous window. +.B Mod\-Shift\-f +Set layout to floating + .TP -.B Mod1\-i -Increase number of windows in master area. +.B Mod\-Shift\-m +Set layout to monocle + .TP -.B Mod1\-d -Decrease number of windows in master area. +.B Mod\-Shift\-u +Set layout to centred monocle + .TP -.B Mod1\-l -Increase master area size. +.B Mod\-Shift\-o +Set layout to centred floating monocle + .TP -.B Mod1\-h -Decrease master area size. +.B Mod\-Shift\-s +Set layout to spiral fibonacci + .TP -.B Mod1\-Return -Zooms/cycles focused window to/from master area (tiled layouts only). +.B Mod\-Shift\-d +Set layout to dwindle fibonacci + .TP -.B Mod1\-Shift\-c -Close focused window. +.B Mod\-Shift\-g +Set layout to gapless grid + .TP -.B Mod1\-Shift\-space -Toggle focused window between tiled and floating state. +.B Mod\-Shift\-i +Set layout to deck + .TP -.B Mod1\-Tab -Toggles to the previously selected tags. +.B Mod\-Shift\-space +Toggle between current layout and previous layout + +.TP +.B Mod\-space +Toggle current client's floating (floating -> not floating, not floating -> floating) + +.TP +.B Mod1\-[1..n] +Go to nth tag + .TP .B Mod1\-Shift\-[1..n] -Apply nth tag to focused window. +Send focused client to nth tag. + .TP -.B Mod1\-Shift\-0 -Apply all tags to focused window. +.B Mod\-m +Focus on the next monitor in monitor stack + .TP -.B Mod1\-Control\-Shift\-[1..n] -Add/remove nth tag to/from focused window. +.B Mod\-Shift\-, +Send client to previous monitor in monitor stack + .TP -.B Mod1\-[1..n] -View all windows with nth tag. +.B Mod\-Shift\-. +Send client to next monitor in monitor stack + .TP -.B Mod1\-0 -View all windows with any tag. +.B Mod\-Tab +View the previous tag + .TP -.B Mod1\-Control\-[1..n] -Add/remove all windows with nth tag to/from the view. +.B Mod\-q +Kill the currently focused client + .TP -.B Mod1\-Shift\-q -Quit dwm. +.B Mod\-Shift\-q +Kill dwm + .SS Mouse commands + .TP .B Mod1\-Button1 Move focused window while dragging. Tiled windows will be toggled to the floating state. + .TP .B Mod1\-Button2 Toggles focused window between floating and tiled state. + .TP .B Mod1\-Button3 Resize focused window while dragging. Tiled windows will be toggled to the floating state. + .SH CUSTOMIZATION dwm is customized by creating a custom config.h and (re)compiling the source code. This keeps it fast, secure and simple. |