Warp.hs: +doc

Describe how to emulate Ratpoison's 'banish' functionality on one's config

XMonad/Actions/Warp.hs

@@ -39,6 +39,16 @@ then add appropriate keybindings to warp the pointer; for example:
 >       | (key, sc) <- zip [xK_w, xK_e, xK_r] [0..]]
 
 Note that warping to a particular screen may change the focus.
+
+warpToScreen and warpToWindow can be used in a variety of ways. Suppose you wanted to emulate
+Ratpoison's 'banish' command, which moves the mouse pointer to a corner; you could define:
+> banish :: X ()
+> banish = warpToWindow 1 1 -- lower left
+
+And if you wanted to run it on every window or focus movement, you could put it
+into your xmonad.hs's logHook (which activates on every change) like thus:
+
+>        , logHook = banish
 -}
 
 -- For detailed instructions on editing your key bindings, see