mirror of
https://github.com/xmonad/xmonad.git
synced 2025-08-06 07:01:52 -07:00
more polish for config doc
This commit is contained in:
28
CONFIG
28
CONFIG
@@ -4,8 +4,8 @@ xmonad is configured by creating and editing the Haskell file:
|
|||||||
|
|
||||||
~/.xmonad/xmonad.hs
|
~/.xmonad/xmonad.hs
|
||||||
|
|
||||||
xmonad then uses default settings from this file as arguments to the
|
xmonad then uses settings from this file as arguments to the window manager,
|
||||||
window manager.
|
on startup.
|
||||||
|
|
||||||
== A simple example ==
|
== A simple example ==
|
||||||
|
|
||||||
@@ -25,23 +25,14 @@ the border width, default terminal, and some colours:
|
|||||||
, normalBorderColor = "#cccccc"
|
, normalBorderColor = "#cccccc"
|
||||||
, focusedBorderColor = "#cd8b00" }
|
, focusedBorderColor = "#cd8b00" }
|
||||||
|
|
||||||
This will run 'xmonad', the window manager, with your settings passed as
|
You can find the defaults in the file:
|
||||||
arguments.
|
|
||||||
|
|
||||||
Overriding default settings like this (using "record update syntax"),
|
|
||||||
will yield the shortest config file, as you only have to describe values
|
|
||||||
that differ from the defaults.
|
|
||||||
|
|
||||||
An alternative is to inline the entire default config file from xmonad,
|
|
||||||
and edit values you wish to change. This is requires more work, but some
|
|
||||||
users may find this easier. You can find the defaults in the file:
|
|
||||||
|
|
||||||
XMonad/Config.hs
|
XMonad/Config.hs
|
||||||
|
|
||||||
== Checking your xmonad.hs is correct ==
|
== Checking your xmonad.hs is correct ==
|
||||||
|
|
||||||
Place this text in ~/.xmonad/xmonad.hs, and then check that it is
|
Place this text in ~/.xmonad/xmonad.hs, and then check that it is
|
||||||
syntactically and type correct, by loading it in the Haskell
|
syntactically and type correct by loading it in the Haskell
|
||||||
interpreter:
|
interpreter:
|
||||||
|
|
||||||
$ ghci ~/.xmonad/xmonad.hs
|
$ ghci ~/.xmonad/xmonad.hs
|
||||||
@@ -56,10 +47,13 @@ Ok, looks good.
|
|||||||
|
|
||||||
== Loading your configuration ==
|
== Loading your configuration ==
|
||||||
|
|
||||||
To have xmonad start using your settings, try mod-q. xmonad will attempt
|
To have xmonad start using your settings, type 'mod-q'. xmonad will
|
||||||
to compile this file, and run it. If it is unable to, the defaults are
|
then load this new file, and run it. If it is unable to, the defaults
|
||||||
used. This requires GHC and xmonad are in your $PATH settings. If
|
are used.
|
||||||
GHC isn't in your path, you can still compile the xmonad.hs file yourself:
|
|
||||||
|
To load succesfully, both 'xmonad' and 'ghc' must be in your $PATH
|
||||||
|
environment variable. If GHC isn't in your path, for some reason, you
|
||||||
|
can compile the xmonad.hs file yourself:
|
||||||
|
|
||||||
$ cd ~/.xmonad
|
$ cd ~/.xmonad
|
||||||
$ ghc --make xmonad.hs
|
$ ghc --make xmonad.hs
|
||||||
|
Reference in New Issue
Block a user