Go to file
Jens Petersen 7914f5f0d0 update to 0.10, cabal2spec-0.24.1, re-enable haddock 2011-12-03 00:08:13 +09:00
.gitignore update to 0.10, cabal2spec-0.24.1, re-enable haddock 2011-12-03 00:08:13 +09:00
README.fedora more improvements to README.fedora 2011-05-26 10:46:02 +09:00
sources update to 0.10, cabal2spec-0.24.1, re-enable haddock 2011-12-03 00:08:13 +09:00
xmonad-0.9.1-ghc7-base4.patch backport exceptions changes from upstream darcs for ghc7 base4 2010-11-26 23:45:53 +10:00
xmonad-dynamic-link.patch update to 0.10, cabal2spec-0.24.1, re-enable haddock 2011-12-03 00:08:13 +09:00
xmonad-gnome-session.desktop add a gnome xsession file and a gnome-session file 2011-04-22 18:18:40 +09:00
xmonad-session.desktop fix gnome-session fail-whale dialog and setup gnomeConfig if available 2011-05-12 18:53:28 +09:00
xmonad-start use -no-user-package-conf when compiling xmonad.hs; no longer show README; cabal2spec-0.23.2 2011-06-22 17:02:51 +09:00
xmonad.desktop fix gnome-session fail-whale dialog and setup gnomeConfig if available 2011-05-12 18:53:28 +09:00
xmonad.session add a gnome xsession file and a gnome-session file 2011-04-22 18:18:40 +09:00
xmonad.spec update to 0.10, cabal2spec-0.24.1, re-enable haddock 2011-12-03 00:08:13 +09:00

README.fedora

= Packaging =
xmonad in Fedora is provided by 3 packages:

- xmonad-core: just the base window manager and X session files
- xmonad: additionally installs the devel library files needed to configure and customize xmonad
- xmonad-gnome: additionally includes a gnome session file and requires gnome-session and gnome-terminal

= Starting from GDM =
xmonad can be started from GDM by selecting "xmonad" in the session menu.

For GNOME support please install xmonad-gnome
and select "xmonad GNOME" in GDM's session menu, which will run
"gnome-session --session=xmonad".

= xmonad-start =
For new users without "~/.xmonad/", Fedora's xmonad-start script
displays "man xmonad" and "less README.fedora" in xterms to provide help initially.

To stop this behaviour, just create "~/.xmonad/".

For an xmonad-gnome session for new users, xmonad-start will create
a basic "~/.xmonad/xmonad.hs" file configured for Gnome.

= Customizing and configuring xmonad =
For documentation and examples see:
- xmonad man-page
- /usr/share/doc/xmonad-$version/xmonad.hs (full default basic configuration)
- /usr/share/doc/ghc/html/libraries/xmonad-contrib-$version/index.html
and online:
- Xmonad wiki: http://www.haskell.org/haskellwiki/Xmonad
- http://hackage.haskell.org/packages/archive/xmonad-contrib/latest/doc/html/XMonad-Doc.html
  (detailed configuration information and examples)
- http://xmonad.org/ website

To make use of extensions and Desktop Environment support,
you need to install ghc-xmonad-contrib-devel.

== Configuration for Desktop Environments ==
The default xmonad configuration does not work well with desktop environments.

The following basic generic configuration requires ghc-xmonad-contrib-devel
to be installed, and should get it working:

$ mkdir ~/.xmonad
$ cat > ~/.xmonad/xmonad.hs << EOF
import XMonad
import XMonad.Config.Desktop

main = xmonad desktopConfig
EOF
$ 

You can replace the generic "[Dd]esktop" by:
- "[Gg]nome" for better GNOME support
- "[Kk]de[4]" for KDE support
- "[Xx]fce" for XFCE support.

See:
- http://hackage.haskell.org/packages/archive/xmonad-contrib/latest/doc/html/XMonad-Config-Desktop.html
- http://haskell.org/haskellwiki/Xmonad/Basic_Desktop_Environment_Integration
for more info on how to setup desktop support.

= Bluetile =
New users may find the Bluetile window manager built on top of
xmonad-contrib a gentler introduction to xmonad and tiling.