X-Git-Url: https://jasonwoof.com/gitweb/?p=dwm.git;a=blobdiff_plain;f=dwm.1;h=5268a06424caab7cf9191784b1a7fee9d8636f6e;hp=b1b04ebbbcf7243ddf58b5e329d6c7a9dc97b05d;hb=1479e76f01bf066c441e096ad3f9370b433ce552;hpb=796925089cff58fbea4a1954cf0df57a6a648562 diff --git a/dwm.1 b/dwm.1 index b1b04eb..5268a06 100644 --- a/dwm.1 +++ b/dwm.1 @@ -5,27 +5,28 @@ dwm \- dynamic window manager .B dwm .RB [ \-v ] .SH DESCRIPTION -dwm is a dynamic window manager for X. It manages windows in tiled and -floating layouts. Either layout can be applied dynamically, optimizing the +dwm is a dynamic window manager for X. It manages windows in tiled, monocle +and floating layouts. Either layout can be applied dynamically, optimising the environment for the application in use and the task performed. .P -In tiled layout windows are managed in a master and stacking area. The master -area contains the windows which currently need 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. +In tiled layouts 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 monocle layout all windows are +maximised to the screen size. 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. Each window can be tagged with one or multiple tags. Selecting certain tags displays all windows with these tags. .P -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. +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 @@ -35,8 +36,10 @@ prints version information to standard output, then exits. .SH USAGE .SS Status bar .TP -.B Standard input -is read and displayed in the status text area. +.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 Button1 click on a tag label to display all windows with that tag, click on the layout @@ -54,13 +57,34 @@ click on a tag label adds/removes that tag to/from the focused window. .TP .B Mod1\-Shift\-Return Start -.BR xterm. +.BR uxterm (1). .TP -.B Mod1\-Return -Zooms/cycles current window to/from master area (tiled layout only). +.B Mod1\-, +Focus previous screen, if any. +.TP +.B Mod1\-. +Focus next screen, if any. +.TP +.B Mod1\-Shift\-, +Send focused window to previous screen, if any. +.TP +.B Mod1\-Shift\-. +Send focused window to next screen, if any. .TP .B Mod1\-b -Shows/hides the status bar. +Toggles bar on and off. +.TP +.B Mod1\-t +Sets tiled layout. +.TP +.B Mod1\-f +Sets floating layout. +.TP +.B Mod1\-m +Sets monocle layout. +.TP +.B Mod1\-space +Toggles between current and previous layout. .TP .B Mod1\-j Focus next window. @@ -68,95 +92,81 @@ Focus next window. .B Mod1\-k Focus previous window. .TP +.B Mod1\-i +Increase clients in master area. +.TP +.B Mod1\-d +Decrease clients in master area. +.TP .B Mod1\-l -Increase the number of windows in the master area (tiled layout only). +Increase master area size. .TP .B Mod1\-h -Decrease the number of windows in the master area (tiled layout only). -.TP -.B Mod1\-Shift\-j -Increase vertical tile ratio, effects tile heights (tiled layout only). +Decrease master area size. .TP -.B Mod1\-Shift\-k -Decrease vertical tile ratio, effects tile heights (tiled layout only). +.B Mod1\-Return +Zooms/cycles focused window to/from master area (tiled layouts only). .TP -.B Mod1\-Shift\-l -Increase horizontal tile ratio, effects master area width (tiled layout only). +.B Mod1\-Shift\-c +Close focused window. .TP -.B Mod1\-Shift\-h -Decrease horizontal tile ratio, effects master area width (tiled layout only). +.B Mod1\-Shift\-space +Toggle focused window between tiled and floating state. .TP -.B Mod1\-m -Toggles maximization of current window (floating layout only). +.B Mod1\-Tab +Toggles to the previously selected tags. .TP .B Mod1\-Shift\-[1..n] -Apply -.RB nth -tag to current window. +Apply nth tag to focused window. .TP .B Mod1\-Shift\-0 -Apply all tags to current window. +Apply all tags to focused 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 (tiled layout only). +Add/remove nth tag to/from focused window. .TP .B Mod1\-[1..n] -View all windows with -.BR nth -tag. +View all windows with 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. +Add/remove all windows with 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 (floating layout only). +Move focused window while dragging. Tiled windows will be toggled to the floating state. .TP .B Mod1\-Button2 -Zooms/cycles current window to/from master area (tiled layout only). +Toggles focused window between floating and tiled state. .TP .B Mod1\-Button3 -Resize current window while dragging (floating layout only). +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 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 . +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 . .P -Recent GTK 2.10.9+ versions contain a broken +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