X-Git-Url: https://jasonwoof.com/gitweb/?p=dwm.git;a=blobdiff_plain;f=dwm.1;h=564ef7e7aaa54cbf5ed577ba1f3fb435c6d552ae;hp=6ae2c393744180880a69f9eeba8cc7321973bebb;hb=dc5c070c44d9af434405c8d6538abd06299d3298;hpb=e6cbe9c11e88537d74eb094ba5844f71ee57f268 diff --git a/dwm.1 b/dwm.1 index 6ae2c39..564ef7e 100644 --- a/dwm.1 +++ b/dwm.1 @@ -1,109 +1,80 @@ -.TH DWM 1 dwm-0.1 +.TH DWM 1 dwm-0.7 .SH NAME dwm \- dynamic window manager .SH SYNOPSIS .B dwm .RB [ \-v ] .SH DESCRIPTION -.SS Overview .B dwm -is a dynamic window manager for X11. It consists of a small status bar at the -top of the screen and arranges windows in either a tiled or floating mode. +is a dynamic window manager for X11. It manages windows in tiling and floating +modes. Either mode can be applied dynamically, optimizing the environment for +the application in use and the task performed. .P -If -.B dwm -is in tiled mode, it consists of two columns. The left master column -contains only one window per time, the right column contains all other windows -in a stack. In tiled mode -.B dwm -.B don't -handles incremental resizals, some terminal programs like -.B xterm -may not work correctly with this in tiled mode. -.P -If -.B dwm -is in floating mode, it arranges all windows with the reqyested geometry and -allows the user to move or resize them. Some windows, like -dialog windows, are treated floating even if -.B dwm -is in tiled mode. In floating mode -.B dwm -handles incremental resizals. +In tiling mode windows are managed in a master and stacking column. The master +column contains the window which currently needs most attention, whereas the +stacking column contains all other windows. In floating mode windows can be +resized and moved freely. Dialog windows are always managed floating, +regardless of the mode selected. .P -Windows are grouped by tags. You can view all windows with a specific tag per -time. However, each window is allowed to contain more than one tag, which -allows to make windows visible in all views. +Windows are grouped by tags. Each window can be tagged with one or multiple +tags. Selecting a certain tag for viewing will display all windows with that +tag. .P .B dwm -reads from -.I stdin -to display status text, if written. -.P -.B dwm -draws 1-pixel borders around windows to indicate the focus state and save as -much screen real estate as possible. Unfocused windows contain a small bar -in front of the window indicating the tags and the window title. -.SS Options +has a small status bar which displays the text read from standard +input, if written. Besides that, it displays all available tags, and the title +of the focused window. It draws a 1-pixel border around windows to +indicate the focus state. Unfocused windows contain a small bar in front of +them displaying their tags and title. +.SH OPTIONS .TP .B \-v -prints version information to -.I stdout -, then exits. -.SS Customization -.B dwm -is customized through editing its source code. It is assumed that -dwm users are high experienced users who know how a window manager works -and who are able to patch -.B dwm -for their needs. This keeps -.B dwm -fast, secure and simple, because it does not process any input data, except -window properties and the status text read from -.I stdin . -.SS Default Key Bindings -.TP 16 -.I Key -.I Action +prints version information to standard output, then exits. +.SH USAGE .TP .B Mod1-Return Zoom .B window to the .B master -track +column .TP -.B Mod1-k +.B Mod1-h Focus previous -.B window +.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 +.B nth tag .TP .B Mod1-space -(Re-)arrange -.B all -windows tiled -.TP -.B Mod1-Shift-space -(Re-)arrange -.B all -windows floating +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 nth tag +to current .B window .TP .B Mod1-Shift-q @@ -114,20 +85,11 @@ Quit Start .B terminal .TP -.B Mod1-Shift-w -Start -.B web browser -.TP -.B Mod1-Shift-l -Lock -.B screen -.TP -.B Control-[0..n] +.B Mod1-Control-[0..n] Append -.B nth -tag to cureent +.B nth tag +to current .B window -.SS Default Mouse Bindings .TP .B Mod1-Button1 Moves current @@ -142,7 +104,7 @@ Lowers current Resizes current .B window while dragging -.SH BUGS -Some terminal programs do not behave correctly in tiled mode, because -incremental resizals are ignored to use maximum screen real estate. You can -patch the code to fix this. +.SH CUSTOMIZATION +.B dwm +is customized by creating a custom config.h and (re)compiling the source +code. This keeps it fast, secure and simple.