xmonad/README.fedora

66 lines
2.3 KiB
Plaintext
Raw Normal View History

= Packaging =
xmonad in Fedora is provided by 3 packages:
- xmonad-core: just the base window manager and X session files
2011-05-26 01:46:02 +00:00
- 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 =
2011-05-26 01:46:02 +00:00
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/".
2011-05-26 01:46:02 +00:00
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.
2011-04-22 09:52:56 +00:00
= Bluetile =
New users may find the Bluetile window manager built on top of
xmonad-contrib a gentler introduction to xmonad and tiling.