dwm.1
changeset 82 3954fc13b2e8
parent 80 8125f908c80c
child 83 ca809fdd30ea
equal deleted inserted replaced
81:92f0d50475be 82:3954fc13b2e8
     1 .TH DWM 1 dwm-0.1
     1 .TH DWM 1 dwm-0.2
     2 .SH NAME
     2 .SH NAME
     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 .B dwm
     8 .B dwm
     9 is a dynamic window manager for X11. It consists of a small status bar and
     9 is a dynamic window manager for X11. It manages windows in tiling and floating
    10 arranges windows in either a tiled or floating mode.
    10 modes. Either mode can be applied dynamically, depending on the application in
       
    11 use and the task performed.
    11 .P
    12 .P
    12 In tiled mode
    13 In tiling mode windows are managed in a master and stacking column. The master
    13 .B dwm
    14 column contains the window which needs most attention at a time, whereas the
    14 manages all windows in a left master column and a right stacking column. The
    15 stacking column contains all other windows in a stack.  Dialog windows are
    15 master column contains a single window, the left stacking column all other
    16 managed floating, however. In floating mode windows can be resized and moved
    16 windows. Dialog windows are treated floating.
    17 freely.
    17 .P
    18 .P
    18 In floating mode
    19 Windows are grouped by tags. All windows with a specific tag can be viewed at a
    19 .B dwm
    20 time. But each window may contain more than one tag, which makes it visible in
    20 manages all windows in a conventional way. They can be resized and moved freely
    21 several views.
    21 with the mouse.
       
    22 .P
    22 .P
    23 Windows are grouped by tags. You can view all windows with a specific tag per
    23 It consists of a small status bar which reads the text displayed from standard
    24 time.  However, each window is allowed to contain more than one tag, which
    24 input, if written. It draws 1-pixel borders around windows to indicate the
    25 allows to make windows visible in all views.
    25 focus state. Unfocused windows contain a small bar in front of the window
    26 .P
    26 displaying the tags and the window title.
    27 .B dwm
       
    28 reads from standard input to display status text, if written.
       
    29 .P
       
    30 .B dwm
       
    31 draws 1-pixel borders around windows to indicate the focus state and providing as
       
    32 much screen real estate as possible. Unfocused windows contain a small bar
       
    33 in front of the window indicating the tags and the window title.
       
    34 .SH OPTIONS
    27 .SH OPTIONS
    35 .TP
    28 .TP
    36 .B \-v
    29 .B \-v
    37 prints version information to standard output, then exits.
    30 prints version information to standard output, then exits.
    38 .SH CUSTOMIZATION
    31 .SH USAGE
    39 .B dwm
       
    40 is customized through editing its source code. It is assumed that
       
    41 .B dwm
       
    42 users know to patch it for their needs. This keeps it fast, secure and simple,
       
    43 because it does not process any input data, except window properties and
       
    44 the status text read from standard input.
       
    45 .SS Keyboard Control
       
    46 .TP 16
       
    47 .I Key	
       
    48 .I Action
       
    49 .TP
    32 .TP
    50 .B Mod1-Return
    33 .B Mod1-Return
    51 Zoom
    34 Zoom
    52 .B window
    35 .B window
    53 to the 
    36 to the 
   106 .B Control-[0..n]
    89 .B Control-[0..n]
   107 Append
    90 Append
   108 .B nth
    91 .B nth
   109 tag to cureent
    92 tag to cureent
   110 .B window
    93 .B window
   111 .SS Mouse Control
    94 .TP
       
    95 .B Control-Button1
       
    96 Zooms the clicked
       
    97 .B window
       
    98 to master column
   112 .TP
    99 .TP
   113 .B Mod1-Button1
   100 .B Mod1-Button1
   114 Moves current
   101 Moves current
   115 .B window
   102 .B window
   116 while dragging
   103 while dragging
   121 .TP
   108 .TP
   122 .B Mod1-Button3
   109 .B Mod1-Button3
   123 Resizes current
   110 Resizes current
   124 .B window
   111 .B window
   125 while dragging
   112 while dragging
       
   113 .SH CUSTOMIZATION
       
   114 .B dwm
       
   115 is customized through editing its source code.  This keeps it fast, secure and
       
   116 simple. The source code contains the
       
   117 .I CUSTOMIZE
       
   118 keyword to highlight relevant portions for customization.