Sophie

Sophie

distrib > Fedora > 14 > i386 > by-pkgid > 97b7e04d4a67814e1160568251f09714 > files > 417

ghc-xmonad-contrib-devel-0.9.1-8.fc14.i686.rpm

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<!--Rendered using the Haskell Html Library v0.2-->
<HTML
><HEAD
><META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=UTF-8"
><TITLE
>XMonad.Actions.WindowNavigation</TITLE
><LINK HREF="haddock.css" REL="stylesheet" TYPE="text/css"
><SCRIPT SRC="haddock-util.js" TYPE="text/javascript"
></SCRIPT
><SCRIPT TYPE="text/javascript"
>window.onload = function () {setSynopsis("mini_XMonad-Actions-WindowNavigation.html")};</SCRIPT
></HEAD
><BODY
><TABLE CLASS="vanilla" CELLSPACING="0" CELLPADDING="0"
><TR
><TD CLASS="topbar"
><TABLE CLASS="vanilla" CELLSPACING="0" CELLPADDING="0"
><TR
><TD
><IMG SRC="haskell_icon.gif" WIDTH="16" HEIGHT="16" ALT=" "
></TD
><TD CLASS="title"
>xmonad-contrib-0.9.1: Third party extensions for xmonad</TD
><TD CLASS="topbut"
><A HREF="src/XMonad-Actions-WindowNavigation.html"
>Source code</A
></TD
><TD CLASS="topbut"
><A HREF="index.html"
>Contents</A
></TD
><TD CLASS="topbut"
><A HREF="doc-index.html"
>Index</A
></TD
></TR
></TABLE
></TD
></TR
><TR
><TD CLASS="modulebar"
><TABLE CLASS="vanilla" CELLSPACING="0" CELLPADDING="0"
><TR
><TD
><FONT SIZE="6"
>XMonad.Actions.WindowNavigation</FONT
></TD
><TD ALIGN="right"
><TABLE CLASS="narrow" CELLSPACING="0" CELLPADDING="0"
><TR
><TD CLASS="infohead"
>Maintainer</TD
><TD CLASS="infoval"
>Devin Mullins &lt;me@twifkak.com&gt;</TD
></TR
></TABLE
></TD
></TR
></TABLE
></TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD
><TABLE CLASS="vanilla" CELLSPACING="0" CELLPADDING="0"
><TR
><TD CLASS="section4"
><B
>Contents</B
></TD
></TR
><TR
><TD
><DL
><DT
><A HREF="#1"
>Usage
</A
></DT
></DL
></TD
></TR
></TABLE
></TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="section1"
>Description</TD
></TR
><TR
><TD CLASS="doc"
><P
>License     :  BSD3-style (see LICENSE)
 Stability   :  unstable
 Portability :  unportable
</P
><P
>This is a rewrite of <A HREF="XMonad-Layout-WindowNavigation.html"
>XMonad.Layout.WindowNavigation</A
>.  WindowNavigation
 lets you assign keys to move up/down/left/right, based on actual cartesian
 window coordinates, rather than just going j/k on the stack.
</P
><P
>This module is experimental. You'll have better luck with the original.
</P
><P
>This module differs from the other in a few ways:
</P
><OL
><LI
> You can go up/down/left/right across multiple screens.
</LI
><LI
> It doesn't provide little border colors for your neighboring windows.
</LI
><LI
> It doesn't provide the 'Move' action, which seems to be related to
      the XMonad.Layout.Combo extension.
</LI
><LI
> It tries to be slightly smarter about tracking your current position.
</LI
><LI
> Configuration is different.
</LI
></OL
></TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="section1"
>Synopsis</TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="body"
><TABLE CLASS="vanilla" CELLSPACING="0" CELLPADDING="0"
><TR
><TD CLASS="decl"
><A HREF="#v%3AwithWindowNavigation"
>withWindowNavigation</A
> ::  (<A HREF="/usr/share/doc/ghc/html/libraries/X11-1.5.0.0/Graphics-X11-Types.html#t%3AKeySym"
>KeySym</A
>, <A HREF="/usr/share/doc/ghc/html/libraries/X11-1.5.0.0/Graphics-X11-Types.html#t%3AKeySym"
>KeySym</A
>, <A HREF="/usr/share/doc/ghc/html/libraries/X11-1.5.0.0/Graphics-X11-Types.html#t%3AKeySym"
>KeySym</A
>, <A HREF="/usr/share/doc/ghc/html/libraries/X11-1.5.0.0/Graphics-X11-Types.html#t%3AKeySym"
>KeySym</A
>) -&gt; <A HREF="/usr/share/doc/ghc/html/libraries/xmonad-0.9.1/XMonad-Core.html#t%3AXConfig"
>XConfig</A
> l -&gt; <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/System-IO.html#t%3AIO"
>IO</A
> (<A HREF="/usr/share/doc/ghc/html/libraries/xmonad-0.9.1/XMonad-Core.html#t%3AXConfig"
>XConfig</A
> l)</TD
></TR
><TR
><TD CLASS="s8"
></TD
></TR
><TR
><TD CLASS="decl"
><A HREF="#v%3AwithWindowNavigationKeys"
>withWindowNavigationKeys</A
> ::  [((<A HREF="/usr/share/doc/ghc/html/libraries/X11-1.5.0.0/Graphics-X11-Types.html#t%3AKeyMask"
>KeyMask</A
>, <A HREF="/usr/share/doc/ghc/html/libraries/X11-1.5.0.0/Graphics-X11-Types.html#t%3AKeySym"
>KeySym</A
>), <A HREF="XMonad-Actions-WindowNavigation.html#t%3AWNAction"
>WNAction</A
>)] -&gt; <A HREF="/usr/share/doc/ghc/html/libraries/xmonad-0.9.1/XMonad-Core.html#t%3AXConfig"
>XConfig</A
> l -&gt; <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/System-IO.html#t%3AIO"
>IO</A
> (<A HREF="/usr/share/doc/ghc/html/libraries/xmonad-0.9.1/XMonad-Core.html#t%3AXConfig"
>XConfig</A
> l)</TD
></TR
><TR
><TD CLASS="s8"
></TD
></TR
><TR
><TD CLASS="decl"
><TABLE CLASS="vanilla" CELLSPACING="0" CELLPADDING="0"
><TR
><TD CLASS="decl"
><SPAN CLASS="keyword"
>data</SPAN
>  <A HREF="#t%3AWNAction"
>WNAction</A
>  </TD
></TR
><TR
><TD CLASS="body"
><TABLE CLASS="vanilla" CELLSPACING="0" CELLPADDING="0"
><TR
><TD CLASS="decl"
>= <A HREF="#v%3AWNGo"
>WNGo</A
> <A HREF="XMonad-Actions-WindowNavigation.html#t%3ADirection2D"
>Direction2D</A
></TD
></TR
><TR
><TD CLASS="decl"
>| <A HREF="#v%3AWNSwap"
>WNSwap</A
> <A HREF="XMonad-Actions-WindowNavigation.html#t%3ADirection2D"
>Direction2D</A
></TD
></TR
></TABLE
></TD
></TR
></TABLE
></TD
></TR
><TR
><TD CLASS="s8"
></TD
></TR
><TR
><TD CLASS="decl"
><A HREF="#v%3Ago"
>go</A
> :: <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/Data-IORef.html#t%3AIORef"
>IORef</A
> WNState -&gt; <A HREF="XMonad-Actions-WindowNavigation.html#t%3ADirection2D"
>Direction2D</A
> -&gt; <A HREF="/usr/share/doc/ghc/html/libraries/xmonad-0.9.1/XMonad-Core.html#t%3AX"
>X</A
> <A HREF="/usr/share/doc/ghc/html/libraries/ghc-prim-0.2.0.0/GHC-Unit.html#t%3A%28%29"
>()</A
></TD
></TR
><TR
><TD CLASS="s8"
></TD
></TR
><TR
><TD CLASS="decl"
><A HREF="#v%3Aswap"
>swap</A
> :: <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/Data-IORef.html#t%3AIORef"
>IORef</A
> WNState -&gt; <A HREF="XMonad-Actions-WindowNavigation.html#t%3ADirection2D"
>Direction2D</A
> -&gt; <A HREF="/usr/share/doc/ghc/html/libraries/xmonad-0.9.1/XMonad-Core.html#t%3AX"
>X</A
> <A HREF="/usr/share/doc/ghc/html/libraries/ghc-prim-0.2.0.0/GHC-Unit.html#t%3A%28%29"
>()</A
></TD
></TR
><TR
><TD CLASS="s8"
></TD
></TR
><TR
><TD CLASS="decl"
><TABLE CLASS="vanilla" CELLSPACING="0" CELLPADDING="0"
><TR
><TD CLASS="decl"
><SPAN CLASS="keyword"
>data</SPAN
>  <A HREF="#t%3ADirection2D"
>Direction2D</A
>  </TD
></TR
><TR
><TD CLASS="body"
><TABLE CLASS="vanilla" CELLSPACING="0" CELLPADDING="0"
><TR
><TD CLASS="decl"
>= <A HREF="#v%3AU"
>U</A
></TD
></TR
><TR
><TD CLASS="decl"
>| <A HREF="#v%3AD"
>D</A
></TD
></TR
><TR
><TD CLASS="decl"
>| <A HREF="#v%3AR"
>R</A
></TD
></TR
><TR
><TD CLASS="decl"
>| <A HREF="#v%3AL"
>L</A
></TD
></TR
></TABLE
></TD
></TR
></TABLE
></TD
></TR
></TABLE
></TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="section1"
><A NAME="1"
><A NAME="1"
>Usage
</A
></A
></TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="doc"
><P
>To use it, you're going to apply the <TT
><A HREF="XMonad-Actions-WindowNavigation.html#v%3AwithWindowNavigation"
>withWindowNavigation</A
></TT
> function.
 <TT
><A HREF="XMonad-Actions-WindowNavigation.html#v%3AwithWindowNavigation"
>withWindowNavigation</A
></TT
> performs some IO operations, so the syntax you'll use
 is the same as the spawnPipe example in <A HREF="XMonad-Hooks-DynamicLog.html"
>XMonad.Hooks.DynamicLog</A
>.
 In particular:
</P
><PRE
> main = do
     config &lt;- withWindowNavigation (xK_w, xK_a, xK_s, xK_d)
             $ defaultConfig { ... }
     xmonad config
</PRE
><P
>Here, we pass in the keys for navigation in counter-clockwise order from up.
 It creates keybindings for <TT
>modMask</TT
> to move to window, and <TT
>modMask .|. shiftMask</TT
>
 to swap windows.
</P
><P
>If you want more flexibility over your keybindings, you can use
 <TT
><A HREF="XMonad-Actions-WindowNavigation.html#v%3AwithWindowNavigationKeys"
>withWindowNavigationKeys</A
></TT
>, which takes a list of <TT
>keys</TT
>-esque entries rather
 than a tuple of the four directional keys. See the source code of
 <TT
><A HREF="XMonad-Actions-WindowNavigation.html#v%3AwithWindowNavigation"
>withWindowNavigation</A
></TT
> for an example.
</P
></TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="topdecl"
><TABLE CLASS="declbar"
><TR
><TD CLASS="declname"
><A NAME="v:withWindowNavigation"
><A NAME="v%3AwithWindowNavigation"
></A
></A
><B
>withWindowNavigation</B
> ::  (<A HREF="/usr/share/doc/ghc/html/libraries/X11-1.5.0.0/Graphics-X11-Types.html#t%3AKeySym"
>KeySym</A
>, <A HREF="/usr/share/doc/ghc/html/libraries/X11-1.5.0.0/Graphics-X11-Types.html#t%3AKeySym"
>KeySym</A
>, <A HREF="/usr/share/doc/ghc/html/libraries/X11-1.5.0.0/Graphics-X11-Types.html#t%3AKeySym"
>KeySym</A
>, <A HREF="/usr/share/doc/ghc/html/libraries/X11-1.5.0.0/Graphics-X11-Types.html#t%3AKeySym"
>KeySym</A
>) -&gt; <A HREF="/usr/share/doc/ghc/html/libraries/xmonad-0.9.1/XMonad-Core.html#t%3AXConfig"
>XConfig</A
> l -&gt; <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/System-IO.html#t%3AIO"
>IO</A
> (<A HREF="/usr/share/doc/ghc/html/libraries/xmonad-0.9.1/XMonad-Core.html#t%3AXConfig"
>XConfig</A
> l)</TD
><TD CLASS="declbut"
><A HREF="src/XMonad-Actions-WindowNavigation.html#withWindowNavigation"
>Source</A
></TD
></TR
></TABLE
></TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="topdecl"
><TABLE CLASS="declbar"
><TR
><TD CLASS="declname"
><A NAME="v:withWindowNavigationKeys"
><A NAME="v%3AwithWindowNavigationKeys"
></A
></A
><B
>withWindowNavigationKeys</B
> ::  [((<A HREF="/usr/share/doc/ghc/html/libraries/X11-1.5.0.0/Graphics-X11-Types.html#t%3AKeyMask"
>KeyMask</A
>, <A HREF="/usr/share/doc/ghc/html/libraries/X11-1.5.0.0/Graphics-X11-Types.html#t%3AKeySym"
>KeySym</A
>), <A HREF="XMonad-Actions-WindowNavigation.html#t%3AWNAction"
>WNAction</A
>)] -&gt; <A HREF="/usr/share/doc/ghc/html/libraries/xmonad-0.9.1/XMonad-Core.html#t%3AXConfig"
>XConfig</A
> l -&gt; <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/System-IO.html#t%3AIO"
>IO</A
> (<A HREF="/usr/share/doc/ghc/html/libraries/xmonad-0.9.1/XMonad-Core.html#t%3AXConfig"
>XConfig</A
> l)</TD
><TD CLASS="declbut"
><A HREF="src/XMonad-Actions-WindowNavigation.html#withWindowNavigationKeys"
>Source</A
></TD
></TR
></TABLE
></TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="topdecl"
><TABLE CLASS="declbar"
><TR
><TD CLASS="declname"
><SPAN CLASS="keyword"
>data</SPAN
>  <A NAME="t:WNAction"
><A NAME="t%3AWNAction"
></A
></A
><B
>WNAction</B
>  </TD
><TD CLASS="declbut"
><A HREF="src/XMonad-Actions-WindowNavigation.html#WNAction"
>Source</A
></TD
></TR
></TABLE
></TD
></TR
><TR
><TD CLASS="body"
><TABLE CLASS="vanilla" CELLSPACING="0" CELLPADDING="0"
><TR
><TD CLASS="section4"
>Constructors</TD
></TR
><TR
><TD CLASS="body"
><TABLE CLASS="vanilla" CELLSPACING="1" CELLPADDING="0"
><TR
><TD CLASS="arg"
><A NAME="v:WNGo"
><A NAME="v%3AWNGo"
></A
></A
><B
>WNGo</B
> <A HREF="XMonad-Actions-WindowNavigation.html#t%3ADirection2D"
>Direction2D</A
></TD
><TD CLASS="rdoc"
></TD
></TR
><TR
><TD CLASS="arg"
><A NAME="v:WNSwap"
><A NAME="v%3AWNSwap"
></A
></A
><B
>WNSwap</B
> <A HREF="XMonad-Actions-WindowNavigation.html#t%3ADirection2D"
>Direction2D</A
></TD
><TD CLASS="rdoc"
></TD
></TR
></TABLE
></TD
></TR
></TABLE
></TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="topdecl"
><TABLE CLASS="declbar"
><TR
><TD CLASS="declname"
><A NAME="v:go"
><A NAME="v%3Ago"
></A
></A
><B
>go</B
> :: <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/Data-IORef.html#t%3AIORef"
>IORef</A
> WNState -&gt; <A HREF="XMonad-Actions-WindowNavigation.html#t%3ADirection2D"
>Direction2D</A
> -&gt; <A HREF="/usr/share/doc/ghc/html/libraries/xmonad-0.9.1/XMonad-Core.html#t%3AX"
>X</A
> <A HREF="/usr/share/doc/ghc/html/libraries/ghc-prim-0.2.0.0/GHC-Unit.html#t%3A%28%29"
>()</A
></TD
><TD CLASS="declbut"
><A HREF="src/XMonad-Actions-WindowNavigation.html#go"
>Source</A
></TD
></TR
></TABLE
></TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="topdecl"
><TABLE CLASS="declbar"
><TR
><TD CLASS="declname"
><A NAME="v:swap"
><A NAME="v%3Aswap"
></A
></A
><B
>swap</B
> :: <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/Data-IORef.html#t%3AIORef"
>IORef</A
> WNState -&gt; <A HREF="XMonad-Actions-WindowNavigation.html#t%3ADirection2D"
>Direction2D</A
> -&gt; <A HREF="/usr/share/doc/ghc/html/libraries/xmonad-0.9.1/XMonad-Core.html#t%3AX"
>X</A
> <A HREF="/usr/share/doc/ghc/html/libraries/ghc-prim-0.2.0.0/GHC-Unit.html#t%3A%28%29"
>()</A
></TD
><TD CLASS="declbut"
><A HREF="src/XMonad-Actions-WindowNavigation.html#swap"
>Source</A
></TD
></TR
></TABLE
></TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="topdecl"
><TABLE CLASS="declbar"
><TR
><TD CLASS="declname"
><SPAN CLASS="keyword"
>data</SPAN
>  <A NAME="t:Direction2D"
><A NAME="t%3ADirection2D"
></A
></A
><B
>Direction2D</B
>  </TD
><TD CLASS="declbut"
><A HREF="src/XMonad-Util-Types.html#Direction2D"
>Source</A
></TD
></TR
></TABLE
></TD
></TR
><TR
><TD CLASS="body"
><TABLE CLASS="vanilla" CELLSPACING="0" CELLPADDING="0"
><TR
><TD CLASS="ndoc"
>Two-dimensional directions:
</TD
></TR
><TR
><TD CLASS="section4"
>Constructors</TD
></TR
><TR
><TD CLASS="body"
><TABLE CLASS="vanilla" CELLSPACING="1" CELLPADDING="0"
><TR
><TD CLASS="arg"
><A NAME="v:U"
><A NAME="v%3AU"
></A
></A
><B
>U</B
></TD
><TD CLASS="rdoc"
>Up
</TD
></TR
><TR
><TD CLASS="arg"
><A NAME="v:D"
><A NAME="v%3AD"
></A
></A
><B
>D</B
></TD
><TD CLASS="rdoc"
>Down
</TD
></TR
><TR
><TD CLASS="arg"
><A NAME="v:R"
><A NAME="v%3AR"
></A
></A
><B
>R</B
></TD
><TD CLASS="rdoc"
>Right
</TD
></TR
><TR
><TD CLASS="arg"
><A NAME="v:L"
><A NAME="v%3AL"
></A
></A
><B
>L</B
></TD
><TD CLASS="rdoc"
>Left
</TD
></TR
></TABLE
></TD
></TR
><TR
><TD CLASS="section4"
><IMG SRC="minus.gif" CLASS="coll" ONCLICK="toggle(this,'i:Direction2D')" ALT="show/hide"
> Instances</TD
></TR
><TR
><TD CLASS="body"
><DIV ID="i:Direction2D" STYLE="display:block;"
><TABLE CLASS="vanilla" CELLSPACING="1" CELLPADDING="0"
><TR
><TD CLASS="decl"
><A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/Prelude.html#t%3ABounded"
>Bounded</A
> <A HREF="XMonad-Actions-WindowNavigation.html#t%3ADirection2D"
>Direction2D</A
></TD
></TR
><TR
><TD CLASS="decl"
><A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/Prelude.html#t%3AEnum"
>Enum</A
> <A HREF="XMonad-Actions-WindowNavigation.html#t%3ADirection2D"
>Direction2D</A
></TD
></TR
><TR
><TD CLASS="decl"
><A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/Data-Eq.html#t%3AEq"
>Eq</A
> <A HREF="XMonad-Actions-WindowNavigation.html#t%3ADirection2D"
>Direction2D</A
></TD
></TR
><TR
><TD CLASS="decl"
><A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/Data-Ord.html#t%3AOrd"
>Ord</A
> <A HREF="XMonad-Actions-WindowNavigation.html#t%3ADirection2D"
>Direction2D</A
></TD
></TR
><TR
><TD CLASS="decl"
><A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/Text-Read.html#t%3ARead"
>Read</A
> <A HREF="XMonad-Actions-WindowNavigation.html#t%3ADirection2D"
>Direction2D</A
></TD
></TR
><TR
><TD CLASS="decl"
><A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/Text-Show.html#t%3AShow"
>Show</A
> <A HREF="XMonad-Actions-WindowNavigation.html#t%3ADirection2D"
>Direction2D</A
></TD
></TR
><TR
><TD CLASS="decl"
><A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/Data-Typeable.html#t%3ATypeable"
>Typeable</A
> <A HREF="XMonad-Actions-WindowNavigation.html#t%3ADirection2D"
>Direction2D</A
></TD
></TR
></TABLE
></DIV
></TD
></TR
></TABLE
></TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="botbar"
>Produced by <A HREF="http://www.haskell.org/haddock/"
>Haddock</A
> version 2.6.1</TD
></TR
></TABLE
></BODY
></HTML
>