diff options
Diffstat (limited to 'dwm/dwm.1')
| -rw-r--r-- | dwm/dwm.1 | 213 |
1 files changed, 213 insertions, 0 deletions
diff --git a/dwm/dwm.1 b/dwm/dwm.1 new file mode 100644 index 0000000..62fff83 --- /dev/null +++ b/dwm/dwm.1 @@ -0,0 +1,213 @@ +.TH DWM 1 dwm\-VERSION +.SH NAME +dwm \- dynamic window manager (Luke Smith <https://lukesmith.xyz>'s build) +.SH SYNOPSIS +.B dwm +.RB [ \-v ] +.SH DESCRIPTION +dwm is a dynamic window manager for X. +.P +dwm "orders" windows based on recency and primacy, while dwm layouts may +change, the most recent "master" window is shown in the most prominent +position. There are bindings for cycling through and promoting windows to the +master position. +.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. +.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. +.P +dwm draws a small border around windows to indicate the focus state. +.SH OPTIONS +.TP +.B \-v +prints version information to stderr, then exits. +.SH USAGE +.SS Status bar +.TP +.B X root window name +is read and displayed in the status text area. It can be set with the +.BR xsetroot (1) +command. +.TP +.B Left click +click on a tag label to display all windows with that tag, click on the layout +label toggles between tiled and floating layout. +.TP +.B Right click +click on a tag label adds/removes all windows with that tag to/from the view. +.TP +.B Super\-Left click +click on a tag label applies that tag to the focused window. +.TP +.B Super\-Right click +click on a tag label adds/removes that tag to/from the focused window. +.SS Keyboard commands +.TP +.B Super\-Return +Start terminal, +.BR st(1). +.TP +.B Super\-d +Spawn +.BR dmenu(1) +for launching other programs. +.TP +.B Super\-grave +Spawn +.BR dmenuunicode(1) +for selecting emoji. +.TP +.B Super\-minus/plus, Super\-Shift\-minus/plus +Decrease/increase volume by 5 and 15 respectively. +.TP +.B Super\-b +Toggles bar on and off. +.TP +.B Super\-q +Close focused window. +.TP +.B Super\-t/T +Sets tiled/bstack layouts. +.TP +.B Super\-f +Toggle fullscreen window. +.TP +.B Super\-F +Toggle floating layout. +.TP +.B Super\-y/Y +Sets Fibonacci spiral/dwinde layouts. +.TP +.B Super\-u/U +Sets centered master layout. +.TP +.B Super\-i/I +Sets centered master or floating master layouts. +.TP +.B Super\-space +Zooms/cycles focused window to/from master area. +.TP +.B Super\-j/k +Focus next/previous window. +.TP +.B Super\-Shift\-j/k +Move selected window down/up in stack. +.TP +.B Super\-o/O +Increase/decrease number of windows in master area. +.TP +.B Super\-l +Increase master area size. +.TP +.B Super\-h +Decrease master area size. +.TP +.B Super\-Shift\-space +Toggle focused window between tiled and floating state. +.TP +.B Super\-Tab +Toggles to the previously selected tags. +.TP +.B Super\-g +Moves to the previous tag. +.TP +.B Super\-Shift\-g +Moves selected window to the previous tag. +.TP +.B Super\-; +Moves to the next tag. +.TP +.B Super\-Shift\-; +Moves selected window to the next tag. +.TP +.B Super\-PageUp +Moves to the previous tag. +.TP +.B Super\-Shift\-PageUp +Moves selected window to the previous tag. +.TP +.B Super\-Pagedown +Moves to the next tag. +.TP +.B Super\-Shift\-PageDown +Moves selected window to the next tag. +.TP +.B Super\-a +Toggle gaps. +.TP +.B Super\-z +Increase gaps between windows. +.TP +.B Super\-x +Decrease gaps between windows. +.TP +.B Super\-Shift\-[1..n] +Apply nth tag to focused window. +.TP +.B Super\-Shift\-0 +Apply all tags to focused window. +.TP +.B Super\-Control\-Shift\-[1..n] +Add/remove nth tag to/from focused window. +.TP +.B Super\-[1..n] +View all windows with nth tag. +.TP +.B Super\-0 +View all windows with any tag. +.TP +.B Super\-Control\-[1..n] +Add/remove all windows with nth tag to/from the view. +.TP +.B Super\-Shift\-q +Quit dwm. +.TP +.B Mod1\-Control\-Shift\-q +Menu to refresh/quit/reboot/shutdown. +.SS Mouse commands +.TP +.B Super\-Left click +Move focused window while dragging. Tiled windows will be toggled to the floating state. +.TP +.B Super\-Middle click +Toggles focused window between floating and tiled state. +.TP +.B Super\-Right click +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. +.SH SIGNALS +.TP +.B SIGHUP - 1 +Restart the dwm process. +.TP +.B SIGTERM - 15 +Cleanly terminate the dwm process. +.SH SEE ALSO +.BR dmenu (1), +.BR st (1) +.SH ISSUES +Java applications which use the XToolkit/XAWT backend may draw grey windows +only. The XToolkit/XAWT backend breaks ICCCM-compliance in recent JDK 1.5 and early +JDK 1.6 versions, because it assumes a reparenting window manager. Possible workarounds +are using JDK 1.4 (which doesn't contain the XToolkit/XAWT backend) or setting the +environment variable +.BR AWT_TOOLKIT=MToolkit +(to use the older Motif backend instead) or running +.B xprop -root -f _NET_WM_NAME 32a -set _NET_WM_NAME LG3D +or +.B wmname LG3D +(to pretend that a non-reparenting window manager is running that the +XToolkit/XAWT backend can recognize) or when using OpenJDK setting the environment variable +.BR _JAVA_AWT_WM_NONREPARENTING=1 . +.SH BUGS +Send all bug reports with a patch to hackers@suckless.org. |