dwm.1
changeset 80 8125f908c80c
parent 79 aabebd6e61f3
child 82 3954fc13b2e8
equal deleted inserted replaced
79:aabebd6e61f3 80:8125f908c80c
     3 dwm \- dynamic window manager
     3 dwm \- dynamic window manager
     4 .SH SYNOPSIS
     4 .SH SYNOPSIS
     5 .B dwm
     5 .B dwm
     6 .RB [ \-v ]
     6 .RB [ \-v ]
     7 .SH DESCRIPTION
     7 .SH DESCRIPTION
     8 .SS Overview
       
     9 .B dwm
     8 .B dwm
    10 is a dynamic window manager for X11. It consists of a small status bar at the
     9 is a dynamic window manager for X11. It consists of a small status bar and
    11 top of the screen and arranges windows in either a tiled or floating mode.
    10 arranges windows in either a tiled or floating mode.
    12 .P
    11 .P
    13 If 
    12 In tiled mode
    14 .B dwm
    13 .B dwm
    15 is in tiled mode, it consists of two columns. The left master column
    14 manages all windows in a left master column and a right stacking column. The
    16 contains only one window per time, the right column contains all other windows 
    15 master column contains a single window, the left stacking column all other
    17 in a stack. In tiled mode
    16 windows. Dialog windows are treated floating.
       
    17 .P
       
    18 In floating mode
    18 .B dwm
    19 .B dwm
    19 .B don't
    20 manages all windows in a conventional way. They can be resized and moved freely
    20 handles incremental resizals, some terminal programs like
    21 with the mouse.
    21 .B xterm
       
    22 may not work correctly with this in tiled mode.
       
    23 .P
       
    24 If
       
    25 .B dwm
       
    26 is in floating mode, it arranges all windows with the reqyested geometry and
       
    27 allows the user to move or resize them. Some windows, like
       
    28 dialog windows, are treated floating even if
       
    29 .B dwm
       
    30 is in tiled mode. In floating mode
       
    31 .B dwm
       
    32 handles incremental resizals.
       
    33 .P
    22 .P
    34 Windows are grouped by tags. You can view all windows with a specific tag per
    23 Windows are grouped by tags. You can view all windows with a specific tag per
    35 time.  However, each window is allowed to contain more than one tag, which
    24 time.  However, each window is allowed to contain more than one tag, which
    36 allows to make windows visible in all views.
    25 allows to make windows visible in all views.
    37 .P
    26 .P
    38 .B dwm
    27 .B dwm
    39 reads from
    28 reads from standard input to display status text, if written.
    40 .I stdin
       
    41 to display status text, if written.
       
    42 .P
    29 .P
    43 .B dwm
    30 .B dwm
    44 draws 1-pixel borders around windows to indicate the focus state and save as
    31 draws 1-pixel borders around windows to indicate the focus state and providing as
    45 much screen real estate as possible. Unfocused windows contain a small bar
    32 much screen real estate as possible. Unfocused windows contain a small bar
    46 in front of the window indicating the tags and the window title.
    33 in front of the window indicating the tags and the window title.
    47 .SS Options
    34 .SH OPTIONS
    48 .TP
    35 .TP
    49 .B \-v
    36 .B \-v
    50 prints version information to
    37 prints version information to standard output, then exits.
    51 .I stdout
    38 .SH CUSTOMIZATION
    52 , then exits.
       
    53 .SS Customization
       
    54 .B dwm
    39 .B dwm
    55 is customized through editing its source code. It is assumed that
    40 is customized through editing its source code. It is assumed that
    56 dwm users are high experienced users who know how a window manager works
       
    57 and who are able to patch
       
    58 .B dwm
    41 .B dwm
    59 for their needs. This keeps
    42 users know to patch it for their needs. This keeps it fast, secure and simple,
    60 .B dwm
    43 because it does not process any input data, except window properties and
    61 fast, secure and simple, because it does not process any input data, except
    44 the status text read from standard input.
    62 window properties and the status text read from
    45 .SS Keyboard Control
    63 .I stdin .
       
    64 .SS Default Key Bindings
       
    65 .TP 16
    46 .TP 16
    66 .I Key	
    47 .I Key	
    67 .I Action
    48 .I Action
    68 .TP
    49 .TP
    69 .B Mod1-Return
    50 .B Mod1-Return
    70 Zoom
    51 Zoom
    71 .B window
    52 .B window
    72 to the 
    53 to the 
    73 .B master
    54 .B master
    74 track
    55 column
    75 .TP
    56 .TP
    76 .B Mod1-k
    57 .B Mod1-k
    77 Focus previous
    58 Focus previous
    78 .B window
    59 .B window
    79 .TP
    60 .TP
   125 .B Control-[0..n]
   106 .B Control-[0..n]
   126 Append
   107 Append
   127 .B nth
   108 .B nth
   128 tag to cureent
   109 tag to cureent
   129 .B window
   110 .B window
   130 .SS Default Mouse Bindings
   111 .SS Mouse Control
   131 .TP
   112 .TP
   132 .B Mod1-Button1
   113 .B Mod1-Button1
   133 Moves current
   114 Moves current
   134 .B window
   115 .B window
   135 while dragging
   116 while dragging
   140 .TP
   121 .TP
   141 .B Mod1-Button3
   122 .B Mod1-Button3
   142 Resizes current
   123 Resizes current
   143 .B window
   124 .B window
   144 while dragging
   125 while dragging
   145 .SH BUGS
       
   146 Some terminal programs do not behave correctly in tiled mode, because
       
   147 incremental resizals are ignored to use maximum screen real estate. You can
       
   148 patch the code to fix this.