aboutsummaryrefslogtreecommitdiffstats
path: root/XMonad/Actions/DeManage.hs
blob: 9bff48aa335330f51ae505649e2630888aa0e9c3 (plain) (blame)
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
-----------------------------------------------------------------------------
-- |
-- Module      :  XMonad.Actions.DeManage
-- Copyright   :  (c) Spencer Janssen <sjanssen@cse.unl.edu>
-- License     :  BSD3-style (see LICENSE)
--
-- Maintainer  :  Spencer Janssen <sjanssen@cse.unl.edu>
-- Stability   :  unstable
-- Portability :  unportable
--
-- This module provides a method to cease management of a window, without
-- unmapping it.  This is especially useful for applications like kicker and
-- gnome-panel.
--
-- To make a panel display correctly with xmonad:
--
--  * Determine the pixel size of the panel, add that value to defaultGaps
--
--  * Launch the panel
--
--  * Give the panel window focus, then press mod-d
--
--  * Convince the panel to move\/resize to the correct location.  Changing the
--  panel's position setting several times seems to work.
--
-----------------------------------------------------------------------------

module XMonad.Actions.DeManage (
                                 -- * Usage
                                 -- $usage
                                 demanage
                                ) where

import qualified XMonad.StackSet as W
import XMonad
import XMonad.Operations
import Control.Monad.State
import Graphics.X11 (Window)

-- $usage
-- To use demanage, add this import:
--
-- >     import XMonad.Actions.DeManage
--
-- And add a keybinding to it:
--
-- > , ((modMask,               xK_d     ), withFocused demanage)
--

-- %import XMonad.Actions.DeManage
-- %keybind , ((modMask,               xK_d     ), withFocused demanage)

-- | Stop managing the current focused window.
demanage :: Window -> X ()
demanage w = do
    -- use modify to defeat automatic 'unmanage' calls.
    modify (\s -> s { windowset = W.delete w (windowset s) })
    refresh