X-Git-Url: https://jasonwoof.com/gitweb/?a=blobdiff_plain;f=dwm.1;h=56dd8b9921ed1b7cb62aa4e5e6db84f3634a528d;hb=94f7c2707bcd11de4e0174abe0c2634980dc283e;hp=1e312e96e42845e4cddab52e12fa5d321f3309fd;hpb=f33a30a2074fd1782e6bf2251801a0bcd39d2b27;p=dwm.git diff --git a/dwm.1 b/dwm.1 index 1e312e9..56dd8b9 100644 --- a/dwm.1 +++ b/dwm.1 @@ -1,14 +1,125 @@ -.TH DWM 1 dwm-0.0 +.TH DWM 1 dwm-0.1 .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. -.SS Options +is a dynamic window manager for X11. It consists of a small status bar and +arranges windows in either a tiled or floating mode. +.P +In tiled mode +.B dwm +manages all windows in a left master column and a right stacking column. The +master column contains a single window, the left stacking column all other +windows. Dialog windows are treated floating. +.P +In floating mode +.B dwm +manages all windows in a conventional way. They can be resized and moved freely +with the mouse. +.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. +.P +.B dwm +reads from standard input to display status text, if written. +.P +.B dwm +draws 1-pixel borders around windows to indicate the focus state and providing 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. +.SH OPTIONS .TP .B \-v -prints version information to stdout, then exits. +prints version information to standard output, then exits. +.SH CUSTOMIZATION +.B dwm +is customized through editing its source code. It is assumed that +.B dwm +users know to patch it for their needs. This keeps it fast, secure and simple, +because it does not process any input data, except window properties and +the status text read from standard input. +.SS Keyboard Control +.TP 16 +.I Key +.I Action +.TP +.B Mod1-Return +Zoom +.B window +to the +.B master +column +.TP +.B Mod1-k +Focus previous +.B window +.TP +.B Mod1-j +Focus next +.B window +.TP +.B Mod1-m +Maximize current +.B window +.TP +.B Mod1-[0..n] +Focus +.B nth +tag +.TP +.B Mod1-space +(Re-)arrange +.B all +windows tiled +.TP +.B Mod1-Shift-space +(Re-)arrange +.B all +windows floating +.TP +.B Mod1-Shift-[0..n] +Apply +.B nth +tag to current +.B window +.TP +.B Mod1-Shift-q +Quit +.B dwm +.TP +.B Mod1-Shift-Return +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] +Append +.B nth +tag to cureent +.B window +.SS Mouse Control +.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