all repos — dwm @ 0f3acce0429bc5d2906eaf9279abc5565b189d33

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 X11. 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
 24has a small status bar which displays the text read from standard
 25input, if written. Besides that, it displays all available tags, and the title
 26of the focused window. It draws a 1-pixel border around windows to
 27indicate the focus state. Unfocused windows contain a small bar in front of
 28them displaying their tags and title.
 29.SH OPTIONS
 30.TP
 31.B \-v
 32prints version information to standard output, then exits.
 33.SH USAGE
 34.SS Status bar
 35.TP
 36.B Standard input
 37is read and displayed in the status text area.
 38.TP
 39.B Button[1,2]
 40click on a tag label focuses that
 41.B tag.
 42.TP
 43.B Button3
 44click on a tag label toggles that
 45.B tag.
 46.SS Keyboard commands
 47.TP
 48.B Mod1-Return
 49Zoom current
 50.B window
 51to the 
 52.B master
 53column.
 54.TP
 55.B Mod1-j
 56Focus next
 57.B window.
 58.TP
 59.B Mod1-k
 60Focus previous
 61.B window.
 62.TP
 63.B Mod1-m
 64Maximize current
 65.B window.
 66.TP
 67.B Mod1-[0..n]
 68Focus
 69.B nth tag.
 70.TP
 71.B Mod1-space
 72Toggle between
 73.B tiled
 74and
 75.B floating
 76mode (affects
 77.BR "all windows" ).
 78.TP
 79.B Mod1-Shift-[0..n]
 80Apply
 81.B nth tag
 82to current
 83.B window.
 84.TP
 85.B Mod1-Shift-c
 86Close focused
 87.B window.
 88.TP
 89.B Mod1-Shift-q
 90Quit
 91.B dwm.
 92.TP
 93.B Mod1-Shift-Return
 94Start
 95.B terminal.
 96.TP
 97.B Mod1-Control-[0..n]
 98Toggle
 99.B nth tag.
100.TP
101.B Mod1-Control-Shift-[0..n]
102Append
103.B nth tag
104to current
105.B window.
106.SS Mouse commands
107.TP
108.B Mod1-Button1
109Move current
110.B window
111while dragging.
112.TP
113.B Mod1-Button2
114Zoom current
115.B window
116to the 
117.B master
118column.
119.TP
120.B Mod1-Button3
121Resize current
122.B window
123while dragging.
124.SH CUSTOMIZATION
125.B dwm
126is customized by creating a custom config.h and (re)compiling the source
127code. This keeps it fast, secure and simple.
128.SH CAVEATS
129The status bar displays
130.BR "broken pipe"
131when
132.B dwm
133has been started by
134.BR xdm (1),
135because it closes standard output before executing
136.B dwm.
137.SH SEE ALSO
138.BR dmenu (1)