all repos — dwm @ 39ffc18635686b1a65cd80d19828c4fe2aed982f

fork of suckless dynamic window manager

dwm.1 (view raw)

  1.TH DWM 1 dwm-VERSION
  2.SH NAME
  3dwm \- dynamic window manager
  4.SH SYNOPSIS
  5.B dwm
  6.RB [ \-v ]
  7.SH DESCRIPTION
  8.B dwm
  9is a dynamic window manager for X. It manages windows in tiling and floating
 10modes. Either mode can be applied dynamically, optimizing the environment for
 11the application in use and the task performed.
 12.P
 13In tiling mode windows are managed in a master and stacking column. The master
 14column contains the window which currently needs most attention, whereas the
 15stacking column contains all other windows. In floating mode windows can be
 16resized and moved freely. Dialog windows are always managed floating,
 17regardless of the mode selected.
 18.P
 19Windows are grouped by tags. Each window can be tagged with one or multiple
 20tags. Selecting a certain tag for viewing will display all windows with that
 21tag.
 22.P
 23.B dwm
 24contains a small status bar which displays the text read from standard
 25input. It also displays the title and all active tags of the focused window.
 26.P
 27.B dwm draws a 1-pixel border around windows to indicate the focus state.
 28Unfocused windows contain a small bar in front of them displaying their tags
 29and title.
 30.SH OPTIONS
 31.TP
 32.B \-v
 33prints version information to standard output, then exits.
 34.SH USAGE
 35.SS Status bar
 36.TP
 37.B Standard input
 38is read and displayed in the status text area.
 39.TP
 40.B Button1
 41click on a tag label views all windows with that
 42.BR tag .
 43.TP
 44.B Button3
 45click on a tag label adds/removes all windows with that
 46.B tag
 47to/from the view.
 48.SS Keyboard commands
 49.TP
 50.B Mod1-Shift-Return
 51Start
 52.BR xterm (1).
 53.TP
 54.B Mod1-Tab
 55Focus next
 56.BR window .
 57.TP
 58.B Mod1-Shift-Tab
 59Focus previous
 60.BR window .
 61.TP
 62.B Mod1-Return
 63Zoom current
 64.B window
 65to the 
 66.B master
 67column
 68.RB ( tiling
 69mode only).
 70.TP
 71.B Mod1-m
 72Maximize current
 73.BR window .
 74.TP
 75.B Mod1-Shift-[0..n]
 76Apply
 77.B nth tag
 78to current
 79.BR window .
 80.TP
 81.B Mod1-Control-Shift-[0..n]
 82Add/remove
 83.B nth tag
 84to/from current
 85.BR window .
 86.TP
 87.B Mod1-Shift-c
 88Close focused
 89.B window.
 90.TP
 91.B Mod1-space
 92Toggle between
 93.B tiled
 94and
 95.B floating
 96mode (affects
 97.BR "all windows" ).
 98.TP
 99.B Mod1-[0..n]
100View all windows with
101.BR "tag n" .
102.TP
103.B Mod1-Control-[0..n]
104Add/remove all windows with
105.B tag n
106to/from the view.
107.TP
108.B Mod1-Shift-q
109Quit
110.B dwm.
111.SS Mouse commands
112.TP
113.B Mod1-Button1
114Move current
115.B window
116while dragging
117.RB ( floating
118mode only).
119.TP
120.B Mod1-Button2
121Zoom current
122.B window
123to the 
124.B master
125column
126.RB ( tiling
127mode only).
128.TP
129.B Mod1-Button3
130Resize current
131.B window
132while dragging
133.RB ( floating
134mode only).
135.SH CUSTOMIZATION
136.B dwm
137is customized by creating a custom config.h and (re)compiling the source
138code. This keeps it fast, secure and simple.
139.SH CAVEATS
140The status bar displays
141.B broken pipe
142when
143.B dwm
144has been started by
145.BR xdm (1),
146because it closes standard output before executing
147.BR dwm .
148.SH SEE ALSO
149.BR dmenu (1)