README
author Anselm R.Garbe <arg@10ksloc.org>
Thu, 10 Aug 2006 15:19:25 +0200
changeset 242 cd15de32e173
parent 174 48c820470858
child 316 d69cdb180a3e
permissions -rw-r--r--
prepared 0.8
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
37
eb14fb2c0ee0 small changes to README
Anselm R. Garbe <garbeam@wmii.de>
parents: 34
diff changeset
     1
dwm - dynamic window manager
eb14fb2c0ee0 small changes to README
Anselm R. Garbe <garbeam@wmii.de>
parents: 34
diff changeset
     2
----------------------------
143
36cabfe408cd applied Sanders patches
arg@10ksloc.org
parents: 136
diff changeset
     3
dwm is an extremely fast, small, and dynamic X11 window manager.
17
aaf520f53110 updated README
Anselm R. Garbe <garbeam@wmii.de>
parents: 9
diff changeset
     4
aaf520f53110 updated README
Anselm R. Garbe <garbeam@wmii.de>
parents: 9
diff changeset
     5
0
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
     6
Requirements
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
     7
------------
34
cd30cce52b78 added logo+description
Anselm R. Garbe <garbeam@wmii.de>
parents: 32
diff changeset
     8
In order to build dwm you need the Xlib header files.
0
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
     9
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
    10
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
    11
Installation
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
    12
------------
143
36cabfe408cd applied Sanders patches
arg@10ksloc.org
parents: 136
diff changeset
    13
Edit config.mk to match your local setup (dwm is installed into
36cabfe408cd applied Sanders patches
arg@10ksloc.org
parents: 136
diff changeset
    14
the /usr/local namespace by default).
0
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
    15
172
af781faa40d6 implemented the idea presented by Sander for dwm target
arg@10ksloc.org
parents: 170
diff changeset
    16
Afterwards enter the following command to build and install dwm (if
0
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
    17
necessary as root):
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
    18
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
    19
    make clean install
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
    20
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
    21
34
cd30cce52b78 added logo+description
Anselm R. Garbe <garbeam@wmii.de>
parents: 32
diff changeset
    22
Running dwm
37
eb14fb2c0ee0 small changes to README
Anselm R. Garbe <garbeam@wmii.de>
parents: 34
diff changeset
    23
-----------
34
cd30cce52b78 added logo+description
Anselm R. Garbe <garbeam@wmii.de>
parents: 32
diff changeset
    24
Add the following line to your .xinitrc to start dwm using startx:
0
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
    25
34
cd30cce52b78 added logo+description
Anselm R. Garbe <garbeam@wmii.de>
parents: 32
diff changeset
    26
    exec dwm
0
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
    27
34
cd30cce52b78 added logo+description
Anselm R. Garbe <garbeam@wmii.de>
parents: 32
diff changeset
    28
In order to connect dwm to a specific display, make sure that
0
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
    29
the DISPLAY environment variable is set correctly, e.g.:
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
    30
34
cd30cce52b78 added logo+description
Anselm R. Garbe <garbeam@wmii.de>
parents: 32
diff changeset
    31
    DISPLAY=foo.bar:1 exec dwm
0
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
    32
154
a011f447af88 simplified README
arg@10ksloc.org
parents: 146
diff changeset
    33
(This will start dwm on display :1 of the host foo.bar.)
0
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
    34
143
36cabfe408cd applied Sanders patches
arg@10ksloc.org
parents: 136
diff changeset
    35
In order to display status info in the bar, you can do something
36cabfe408cd applied Sanders patches
arg@10ksloc.org
parents: 136
diff changeset
    36
like this in your .xinitrc:
132
59e997ca04a6 added a note how to achieve status info in the bar
arg@10ksloc.org
parents: 87
diff changeset
    37
59e997ca04a6 added a note how to achieve status info in the bar
arg@10ksloc.org
parents: 87
diff changeset
    38
    while true
59e997ca04a6 added a note how to achieve status info in the bar
arg@10ksloc.org
parents: 87
diff changeset
    39
    do
59e997ca04a6 added a note how to achieve status info in the bar
arg@10ksloc.org
parents: 87
diff changeset
    40
        echo `date` `uptime | sed 's/.*://; s/,//g'`
143
36cabfe408cd applied Sanders patches
arg@10ksloc.org
parents: 136
diff changeset
    41
        sleep 1
135
a4305fb0cfac changed the status info README hint (more simple now, no extra script necessary)
arg@10ksloc.org
parents: 132
diff changeset
    42
    done | dwm
132
59e997ca04a6 added a note how to achieve status info in the bar
arg@10ksloc.org
parents: 87
diff changeset
    43
143
36cabfe408cd applied Sanders patches
arg@10ksloc.org
parents: 136
diff changeset
    44
0
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
    45
Configuration
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
    46
-------------
174
48c820470858 applied Sanders doc changes, added a PHONY line and changed the output of config.h creation somewhat
arg@10ksloc.org
parents: 172
diff changeset
    47
The configuration of dwm is done by creating a custom config.h
48c820470858 applied Sanders doc changes, added a PHONY line and changed the output of config.h creation somewhat
arg@10ksloc.org
parents: 172
diff changeset
    48
and (re)compiling the source code.