X-Git-Url: https://jasonwoof.com/gitweb/?p=dwm.git;a=blobdiff_plain;f=dwm.1;h=c72bb7b0688fd337045d0797b0374bd109a7abaa;hp=974a96501a77004abe00857b702ca4f0d6a4ab4f;hb=fe2775a15ba2d4900788c57194da2bad3d19cfaf;hpb=1bf0c4a8e7892896bb8ed1693f36f1de5285e46c diff --git a/dwm.1 b/dwm.1 index 974a965..c72bb7b 100644 --- a/dwm.1 +++ b/dwm.1 @@ -1,109 +1,153 @@ -.TH DWM 1 dwm-0.7 +.TH DWM 1 dwm\-4.3 .SH NAME dwm \- dynamic window manager .SH SYNOPSIS .B dwm .RB [ \-v ] .SH DESCRIPTION -.B dwm -is a dynamic window manager for X11. It manages windows in tiling and floating -modes. Either mode can be applied dynamically, depending on the application in -use and the task performed. +dwm is a dynamic window manager for X. It manages windows in tiled and +floating layouts. Either layout can be applied dynamically, optimizing the +environment for the application in use and the task performed. .P -In tiling mode windows are managed in a master and stacking column. The master -column contains the window which needs most attention at a time, whereas the -stacking column contains all other windows in a stack. Dialog windows are -managed floating, however. In floating mode windows can be resized and moved -freely. +In tiled layout windows are managed in a master and stacking area. The master +area contains the window which currently needs most attention, whereas the +stacking area contains all other windows. In floating layout windows can be +resized and moved freely. Dialog windows are always managed floating, +regardless of the layout applied. .P -Windows are grouped by tags. All windows with a specific tag can be viewed at a -time. But each window may contain more than one tag, which makes it visible in -several views. +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 -.B dwm -has a small status bar which reads the text displayed from standard -input, if written. It draws 1-pixel borders around windows to indicate the -focus state. Unfocused windows contain a small bar in front of the window -displaying the tags and the window title. +dwm contains a small status bar which displays all available tags, the layout, +the title of the focused window, and the text read from standard input. A +floating window is indicated with an empty square and a maximized +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 standard output, then exits. .SH USAGE +.SS Status bar .TP -.B Mod1-Return -Zoom -.B window -to the -.B master -column -.TP -.B Mod1-h -Focus previous -.B tag -.TP -.B Mod1-j -Focus next -.B window -.TP -.B Mod1-k -Focus previous -.B window -.TP -.B Mod1-l -Focus next -.B tag -.TP -.B Mod1-m -Maximize current -.B window -.TP -.B Mod1-[0..n] -Focus -.B nth tag -.TP -.B Mod1-space -Toggle between -.B tiled -and -.B floating -mode (affects -.BR "all windows" ) -.TP -.B Mod1-Shift-[0..n] -Apply -.B nth tag -to current -.B window +.B Standard input +is read and displayed in the status text area. .TP -.B Mod1-Shift-q -Quit -.B dwm +.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. +.TP +.B Button3 +click on a tag label adds/removes all windows with that tag to/from the view. +.TP +.B Mod1\-Button1 +click on a tag label applies that tag to the focused window. +.TP +.B Mod1\-Button3 +click on a tag label adds/removes that tag to/from the focused window. +.SS Keyboard commands .TP -.B Mod1-Shift-Return +.B Mod1\-Shift\-Return Start -.B terminal -.TP -.B Mod1-Control-[0..n] -Append -.B nth tag -to current -.B window -.TP -.B Mod1-Button1 -Moves current -.B window -while dragging -.TP -.B Mod1-Button2 -Lowers current -.B window -.TP -.B Mod1-Button3 -Resizes current -.B window -while dragging +.BR xterm. +.TP +.B Mod1\-Return +Zooms/cycles current window to/from master area (tiled layout only). +.TP +.B Mod1\-b +Shows/hides the status bar. +.TP +.B Mod1\-h +Decreases the master area width about 5% (tiled layout only). +.TP +.B Mod1\-j +Focus next window. +.TP +.B Mod1\-k +Focus previous window. +.TP +.B Mod1\-l +Increases the master area width about 5% (tiled layout only). +.TP +.B Mod1\-m +Toggles maximization of current window (floating layout only). +.TP +.B Mod1\-Shift\-[1..n] +Apply +.RB nth +tag to current window. +.TP +.B Mod1\-Shift\-0 +Apply all tags to current window. +.TP +.B Mod1\-Control\-Shift\-[1..n] +Add/remove +.B nth +tag to/from current window. +.TP +.B Mod1\-Shift\-c +Close focused window. +.TP +.B Mod1\-space +Toggle between tiled and floating layout (affects all windows). +.TP +.B Mod1\-Shift\-space +Toggle focused window between tiled and floating state. +.TP +.B Mod1\-[1..n] +View all windows with +.BR nth +tag. +.TP +.B Mod1\-0 +View all windows with any tag. +.TP +.B Mod1\-Control\-[1..n] +Add/remove all windows with +.BR nth +tag to/from the view. +.TP +.B Mod1\-Shift\-q +Quit dwm. +.SS Mouse commands +.TP +.B Mod1\-Button1 +Move current window while dragging. Tiled windows will be toggled to the floating state. +.TP +.B Mod1\-Button2 +Zooms/cycles current window to/from master area. If it is floating (but not fixed) it will be toggled to the tiled state instead. +.TP +.B Mod1\-Button3 +Resize current window while dragging. Tiled windows will be toggled to the floating state. .SH CUSTOMIZATION -.B dwm -is customized by editing the file config.h of the source code. -This keeps it fast, secure and simple. +dwm is customized by creating a custom config.h and (re)compiling the source +code. This keeps it fast, secure and simple. +.SH SEE ALSO +.BR dmenu (1) +.SH BUGS +The status bar may display +.BR "EOF" +when dwm has been started by an X session manager like +.BR xdm (1), +because those close standard output before executing dwm. +.P +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. As a workaround +you can use JDK 1.4 (which doesn't contain the XToolkit/XAWT backend) or you +can set the following environment variable (to use the older Motif +backend instead): +.BR AWT_TOOLKIT=MToolkit . +.P +Recent GTK 2.10.9+ versions contain a broken +.BR Save\-As +file dialog implementation, +which requests to reconfigure its window size in an endless loop. However, its +window is still respondable during this state, so you can simply ignore the flicker +until a new GTK version appears, which will fix this bug, approximately +GTK 2.10.12+ versions.