summaryrefslogtreecommitdiffstats
path: root/README
blob: b8f362b94795a37fd7d16fac62228c4dbde2cb97 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
                    xmonad : a tiling window manager

                           http://xmonad.org

    xmonad is a tiling window manager for X. Windows are arranged
    automatically to tile the screen without gaps or overlap, maximising
    screen use. Window manager features are accessible from the
    keyboard: a mouse is optional. xmonad is written, configured and
    extensible in Haskell. Custom layout algorithms, key bindings and
    other extensions may be written by the user in config files. Layouts
    are applied dynamically, and different layouts may be used on each
    workspace. Xinerama is fully supported, allowing windows to be tiled
    on several physical screens.

Quick start:

Obtain the dependent libraries, then build with:

        runhaskell Setup.lhs configure --user --prefix=$HOME
        runhaskell Setup.lhs build
        runhaskell Setup.lhs install --user

For the full story, read on.

Building:

 Building is quite straightforward, and requries a basic Haskell toolchain.
 On many systems xmonad is available as a binary package in your
 package system (e.g. on debian or gentoo). If at all possible, use this
 in preference to a source build, as the dependency resolution will be
 simpler.

 We'll now walk through the complete list of toolchain dependencies.

 * GHC: the Glasgow Haskell Compiler
  
    You first need a Haskell compiler. Your distribution's package
    system will have binaries of GHC (the Glasgow Haskell Compiler), the 
    compiler we use, so install that first. If your operating system's
    package system doesn't provide a binary version of GHC, you can find
    them here:

        http://haskell.org/ghc

    For example, in Debian you would install GHC with:

        apt-get install ghc6

    It shouldn't be necessary to compile GHC from source -- every common 
    system has a pre-build binary version.

 * X11 libraries:

    Since you're building an X application, you'll need the C X11
    library headers. On many platforms, these come pre-installed. For
    others, such as Debian, you can get them from your package manager:

        apt-get install libx11-dev

    Typically you need: libXinerama libXext libX11

 * Cabal
 
    xmonad requires a recent version of Cabal, >= 1.2.0. If you're using
    GHC 6.8, then it comes bundled with the right version. If you're
    using GHC 6.6.x, you'll need to build and install Cabal from hackage
    first:

          http://hackage.haskell.org/cgi-bin/hackage-scripts/package/Cabal

    You can check which version you have with the command:

        $ ghc-pkg list Cabal
        Cabal-1.2.2.0

 * Haskell libraries: mtl, unix, X11

    Finally, you need the Haskell libraries xmonad depends on. Since
    you've a working GHC installation now, most of these will be
    provided. To check whether you've got a package run 'ghc-pkg list
    some_package_name'. You will need the following packages:

    mtl   http://hackage.haskell.org/cgi-bin/hackage-scripts/package/mtl-1.0
    unix  http://hackage.haskell.org/cgi-bin/hackage-scripts/package/unix-2.0 
    X11   http://hackage.haskell.org/cgi-bin/hackage-scripts/package/X11-1.4.1

 * Build xmonad: 

    Once you've got all the dependencies in place (which should be
    straightforward), build xmonad:

        runhaskell Setup.lhs configure --user --prefix=$HOME
        runhaskell Setup.lhs build
        runhaskell Setup.lhs install --user

    And you're done!

------------------------------------------------------------------------

Notes for using the darcs version

    If you're building the darcs version of xmonad, be sure to also
    use the darcs version of the X11 library, which is developed
    concurrently with xmonad.

        darcs get http://darcs.haskell.org/X11

    Not using X11 from darcs is the most common reason for the
    darcs version of xmonad to fail to build.

------------------------------------------------------------------------

Running xmonad:

    Add:

         $HOME/bin/xmonad

    to the last line of your .xsession or .xinitrc file.

------------------------------------------------------------------------

Configuring:

    See the CONFIG document

------------------------------------------------------------------------

XMonadContrib

    There are many extensions to xmonad available in the XMonadContrib
    (xmc) library. Examples include an ion3-like tabbed layout, a
    prompt/program launcher, and various other useful modules.
    XMonadContrib is available at:

        0.6 release:   http://hackage.haskell.org/cgi-bin/hackage-scripts/package/xmonad-contrib-0.6

        darcs version: darcs get http://code.haskell.org/XMonadContrib

------------------------------------------------------------------------

Other useful programs:

 A nicer xterm replacment, that supports resizing better:

    urxvt       http://software.schmorp.de/pkg/rxvt-unicode.html

 For custom status bars:

    dzen        http://gotmor.googlepages.com/dzen
    xmobar      http://hackage.haskell.org/cgi-bin/hackage-scripts/package/xmobar

 For a program dispatch menu:

    dmenu       http://www.suckless.org/download/
    gmrun       (in your package system)

Authors:

    Spencer Janssen
    Don Stewart
    Jason Creighton