content: -----------------------------------------------------------------------------
  -- |
  -- Module      :  XMonad.Actions.Promote
  -- Copyright   :  (c) Miikka Koskinen 2007
  -- License     :  BSD3-style (see LICENSE)
  --
  -- Maintainer  :  xmonad@s001.ethrael.com
  -- Stability   :  unstable
  -- Portability :  unportable
  --
  -- Alternate promote function for xmonad.
  --
  -- Moves the focused window to the master pane. All other windows
  -- retain their order. If focus is in the master, swap it with the
  -- next window in the stack. Focus stays in the master.
  --
  -----------------------------------------------------------------------------
  
  module XMonad.Actions.Promote (
                                   -- * Usage
                                   -- $usage
                                   promote
                                  ) where
  
  import XMonad
  import XMonad.StackSet
  
  -- $usage
  --
  -- You can use this module with the following in your @~\/.xmonad\/xmonad.hs@:
  --
  -- >    import XMonad.Actions.Promote
  --
  -- then add a keybinding or substitute 'promote' in place of swapMaster:
  --
  -- >   , ((modm,               xK_Return), promote)
  --
  -- For detailed instructions on editing your key bindings, see
  -- "XMonad.Doc.Extending#Editing_key_bindings".
  
  -- | Move the focused window to the master pane. All other windows
  --   retain their order. If focus is in the master, swap it with the
  --   next windo in the stack. Focus stays in the master.
  promote :: X ()
  promote = windows $ modify' $
            \c -> case c of
                  Stack _ [] []     -> c
                  Stack t [] (x:rs) -> Stack x [] (t:rs)
                  Stack t ls rs     -> Stack t [] (reverse ls ++ rs)
  