garbeam@68: .TH DWM 1 dwm-0.1 garbeam@0: .SH NAME garbeam@39: dwm \- dynamic window manager garbeam@0: .SH SYNOPSIS garbeam@38: .B dwm garbeam@0: .RB [ \-v ] garbeam@0: .SH DESCRIPTION garbeam@0: .SS Overview garbeam@38: .B dwm garbeam@79: is a dynamic window manager for X11. It consists of a small status bar at the garbeam@79: top of the screen and arranges windows in either a tiled or floating mode. garbeam@79: .P garbeam@79: If garbeam@79: .B dwm garbeam@79: is in tiled mode, it consists of two columns. The left master column garbeam@79: contains only one window per time, the right column contains all other windows garbeam@79: in a stack. In tiled mode garbeam@79: .B dwm garbeam@79: .B don't garbeam@79: handles incremental resizals, some terminal programs like garbeam@79: .B xterm garbeam@79: may not work correctly with this in tiled mode. garbeam@79: .P garbeam@79: If garbeam@79: .B dwm garbeam@79: is in floating mode, it arranges all windows with the reqyested geometry and garbeam@79: allows the user to move or resize them. Some windows, like garbeam@79: dialog windows, are treated floating even if garbeam@79: .B dwm garbeam@79: is in tiled mode. In floating mode garbeam@79: .B dwm garbeam@79: handles incremental resizals. garbeam@79: .P garbeam@79: Windows are grouped by tags. You can view all windows with a specific tag per garbeam@79: time. However, each window is allowed to contain more than one tag, which garbeam@79: allows to make windows visible in all views. garbeam@79: .P garbeam@79: .B dwm garbeam@79: reads from garbeam@79: .I stdin garbeam@79: to display status text, if written. garbeam@79: .P garbeam@79: .B dwm garbeam@79: draws 1-pixel borders around windows to indicate the focus state and save as garbeam@79: much screen real estate as possible. Unfocused windows contain a small bar garbeam@79: in front of the window indicating the tags and the window title. garbeam@0: .SS Options garbeam@0: .TP garbeam@0: .B \-v garbeam@79: prints version information to garbeam@79: .I stdout garbeam@79: , then exits. garbeam@79: .SS Customization garbeam@58: .B dwm garbeam@79: is customized through editing its source code. It is assumed that garbeam@79: dwm users are high experienced users who know how a window manager works garbeam@79: and who are able to patch garbeam@79: .B dwm garbeam@79: for their needs. This keeps garbeam@79: .B dwm garbeam@79: fast, secure and simple, because it does not process any input data, except garbeam@79: window properties and the status text read from garbeam@79: .I stdin . garbeam@55: .SS Default Key Bindings garbeam@55: .TP 16 garbeam@55: .I Key garbeam@55: .I Action garbeam@55: .TP garbeam@55: .B Mod1-Return garbeam@55: Zoom garbeam@55: .B window garbeam@55: to the garbeam@55: .B master garbeam@55: track garbeam@55: .TP garbeam@55: .B Mod1-k garbeam@55: Focus previous garbeam@55: .B window garbeam@55: .TP garbeam@55: .B Mod1-j garbeam@55: Focus next garbeam@55: .B window garbeam@55: .TP garbeam@55: .B Mod1-m garbeam@55: Maximize current garbeam@55: .B window garbeam@55: .TP garbeam@55: .B Mod1-[0..n] garbeam@55: Focus garbeam@55: .B nth garbeam@55: tag garbeam@55: .TP garbeam@55: .B Mod1-space garbeam@55: (Re-)arrange garbeam@55: .B all garbeam@55: windows tiled garbeam@56: .TP garbeam@56: .B Mod1-Shift-space garbeam@56: (Re-)arrange garbeam@56: .B all garbeam@56: windows floating garbeam@56: .TP garbeam@56: .B Mod1-Shift-[0..n] garbeam@56: Apply garbeam@56: .B nth garbeam@56: tag to current garbeam@56: .B window garbeam@56: .TP garbeam@56: .B Mod1-Shift-q garbeam@56: Quit garbeam@56: .B dwm garbeam@56: .TP garbeam@56: .B Mod1-Shift-Return garbeam@56: Start garbeam@56: .B terminal garbeam@56: .TP garbeam@56: .B Mod1-Shift-w garbeam@56: Start garbeam@56: .B web browser garbeam@56: .TP garbeam@56: .B Mod1-Shift-l garbeam@56: Lock garbeam@56: .B screen garbeam@56: .TP garbeam@56: .B Control-[0..n] garbeam@56: Append garbeam@56: .B nth garbeam@56: tag to cureent garbeam@56: .B window garbeam@59: .SS Default Mouse Bindings garbeam@59: .TP garbeam@59: .B Mod1-Button1 garbeam@59: Moves current garbeam@59: .B window garbeam@59: while dragging garbeam@59: .TP garbeam@59: .B Mod1-Button2 garbeam@59: Lowers current garbeam@59: .B window garbeam@59: .TP garbeam@59: .B Mod1-Button3 garbeam@59: Resizes current garbeam@59: .B window garbeam@59: while dragging garbeam@79: .SH BUGS garbeam@79: Some terminal programs do not behave correctly in tiled mode, because garbeam@79: incremental resizals are ignored to use maximum screen real estate. You can garbeam@79: patch the code to fix this.