<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html> <head> <!-- Generated by HsColour, http://www.cs.york.ac.uk/fp/darcs/hscolour/ --> <title>XMonad/Actions/WindowGo.hs</title> <link type='text/css' rel='stylesheet' href='hscolour.css' /> </head> <body> <pre><a name="line-1"></a><span class='hs-comment'>{- | <a name="line-2"></a>Module : XMonad.Actions.WindowGo <a name="line-3"></a>License : Public domain <a name="line-4"></a> <a name="line-5"></a>Maintainer : <gwern0@gmail.com> <a name="line-6"></a>Stability : unstable <a name="line-7"></a>Portability : unportable <a name="line-8"></a> <a name="line-9"></a>Defines a few convenient operations for raising (traveling to) windows based on XMonad's Query <a name="line-10"></a>monad, such as 'runOrRaise'. runOrRaise will run a shell command unless it can <a name="line-11"></a>find a specified window; you would use this to automatically travel to your <a name="line-12"></a>Firefox or Emacs session, or start a new one (for example), instead of trying to <a name="line-13"></a>remember where you left it or whether you still have one running. -}</span> <a name="line-14"></a> <a name="line-15"></a><span class='hs-keyword'>module</span> <span class='hs-conid'>XMonad</span><span class='hs-varop'>.</span><span class='hs-conid'>Actions</span><span class='hs-varop'>.</span><span class='hs-conid'>WindowGo</span> <span class='hs-layout'>(</span> <a name="line-16"></a> <span class='hs-comment'>-- * Usage</span> <a name="line-17"></a> <span class='hs-comment'>-- $usage</span> <a name="line-18"></a> <span class='hs-varid'>raise</span><span class='hs-layout'>,</span> <a name="line-19"></a> <span class='hs-varid'>raiseNext</span><span class='hs-layout'>,</span> <a name="line-20"></a> <span class='hs-varid'>runOrRaise</span><span class='hs-layout'>,</span> <a name="line-21"></a> <span class='hs-varid'>runOrRaiseNext</span><span class='hs-layout'>,</span> <a name="line-22"></a> <span class='hs-varid'>raiseMaybe</span><span class='hs-layout'>,</span> <a name="line-23"></a> <span class='hs-varid'>raiseNextMaybe</span><span class='hs-layout'>,</span> <a name="line-24"></a> <a name="line-25"></a> <span class='hs-varid'>raiseBrowser</span><span class='hs-layout'>,</span> <a name="line-26"></a> <span class='hs-varid'>raiseEditor</span><span class='hs-layout'>,</span> <a name="line-27"></a> <span class='hs-varid'>runOrRaiseAndDo</span><span class='hs-layout'>,</span> <a name="line-28"></a> <span class='hs-varid'>runOrRaiseMaster</span><span class='hs-layout'>,</span> <a name="line-29"></a> <span class='hs-varid'>raiseAndDo</span><span class='hs-layout'>,</span> <a name="line-30"></a> <span class='hs-varid'>raiseMaster</span><span class='hs-layout'>,</span> <a name="line-31"></a> <a name="line-32"></a> <span class='hs-varid'>ifWindows</span><span class='hs-layout'>,</span> <a name="line-33"></a> <span class='hs-varid'>ifWindow</span><span class='hs-layout'>,</span> <a name="line-34"></a> <span class='hs-varid'>raiseHook</span><span class='hs-layout'>,</span> <a name="line-35"></a> <span class='hs-keyword'>module</span> <span class='hs-conid'>XMonad</span><span class='hs-varop'>.</span><span class='hs-conid'>ManageHook</span> <a name="line-36"></a> <span class='hs-layout'>)</span> <span class='hs-keyword'>where</span> <a name="line-37"></a> <a name="line-38"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Control</span><span class='hs-varop'>.</span><span class='hs-conid'>Monad</span> <a name="line-39"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>Char</span> <span class='hs-layout'>(</span><span class='hs-varid'>toLower</span><span class='hs-layout'>)</span> <a name="line-40"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>Monoid</span> <a name="line-41"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>XMonad</span> <span class='hs-layout'>(</span><span class='hs-conid'>Query</span><span class='hs-conid'>()</span><span class='hs-layout'>,</span> <span class='hs-conid'>X</span><span class='hs-conid'>()</span><span class='hs-layout'>,</span> <span class='hs-conid'>ManageHook</span><span class='hs-layout'>,</span> <span class='hs-varid'>withWindowSet</span><span class='hs-layout'>,</span> <span class='hs-varid'>runQuery</span><span class='hs-layout'>,</span> <span class='hs-varid'>liftIO</span><span class='hs-layout'>,</span> <span class='hs-varid'>ask</span><span class='hs-layout'>)</span> <a name="line-42"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Graphics</span><span class='hs-varop'>.</span><span class='hs-conid'>X11</span> <span class='hs-layout'>(</span><span class='hs-conid'>Window</span><span class='hs-layout'>)</span> <a name="line-43"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>XMonad</span><span class='hs-varop'>.</span><span class='hs-conid'>ManageHook</span> <a name="line-44"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>XMonad</span><span class='hs-varop'>.</span><span class='hs-conid'>Operations</span> <span class='hs-layout'>(</span><span class='hs-varid'>windows</span><span class='hs-layout'>)</span> <a name="line-45"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>XMonad</span><span class='hs-varop'>.</span><span class='hs-conid'>Prompt</span><span class='hs-varop'>.</span><span class='hs-conid'>Shell</span> <span class='hs-layout'>(</span><span class='hs-varid'>getBrowser</span><span class='hs-layout'>,</span> <span class='hs-varid'>getEditor</span><span class='hs-layout'>)</span> <a name="line-46"></a><span class='hs-keyword'>import</span> <span class='hs-keyword'>qualified</span> <span class='hs-conid'>XMonad</span><span class='hs-varop'>.</span><span class='hs-conid'>StackSet</span> <span class='hs-keyword'>as</span> <span class='hs-conid'>W</span> <span class='hs-layout'>(</span><span class='hs-varid'>allWindows</span><span class='hs-layout'>,</span> <span class='hs-varid'>peek</span><span class='hs-layout'>,</span> <span class='hs-varid'>swapMaster</span><span class='hs-layout'>,</span> <span class='hs-varid'>focusWindow</span><span class='hs-layout'>)</span> <a name="line-47"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>XMonad</span><span class='hs-varop'>.</span><span class='hs-conid'>Util</span><span class='hs-varop'>.</span><span class='hs-conid'>Run</span> <span class='hs-layout'>(</span><span class='hs-varid'>safeSpawnProg</span><span class='hs-layout'>)</span> <a name="line-48"></a><span class='hs-comment'>{- $usage <a name="line-49"></a> <a name="line-50"></a>Import the module into your @~\/.xmonad\/xmonad.hs@: <a name="line-51"></a> <a name="line-52"></a>> import XMonad.Actions.WindowGo <a name="line-53"></a> <a name="line-54"></a>and define appropriate key bindings: <a name="line-55"></a> <a name="line-56"></a>> , ((modm .|. shiftMask, xK_g), raise (className =? "Firefox")) <a name="line-57"></a>> , ((modm .|. shiftMask, xK_b), runOrRaise "firefox" (className =? "Firefox")) <a name="line-58"></a> <a name="line-59"></a>(Note that Firefox v3 and up have a class-name of \"Firefox\" and \"Navigator\"; <a name="line-60"></a>lower versions use other classnames such as \"Firefox-bin\". Either choose the <a name="line-61"></a>appropriate one, or cover your bases by using instead something like: <a name="line-62"></a> <a name="line-63"></a>> (className =? "Firefox" <||> className =? "Firefox-bin") <a name="line-64"></a> <a name="line-65"></a>For detailed instructions on editing your key bindings, see <a name="line-66"></a>"XMonad.Doc.Extending#Editing_key_bindings". -}</span> <a name="line-67"></a> <a name="line-68"></a><a name="ifWindows"></a><span class='hs-comment'>-- | If windows that satisfy the query exist, apply the supplied</span> <a name="line-69"></a><span class='hs-comment'>-- function to them, otherwise run the action given as</span> <a name="line-70"></a><span class='hs-comment'>-- second parameter.</span> <a name="line-71"></a><span class='hs-definition'>ifWindows</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Query</span> <span class='hs-conid'>Bool</span> <span class='hs-keyglyph'>-></span> <span class='hs-layout'>(</span><span class='hs-keyglyph'>[</span><span class='hs-conid'>Window</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>X</span> <span class='hs-conid'>()</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>X</span> <span class='hs-conid'>()</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>X</span> <span class='hs-conid'>()</span> <a name="line-72"></a><span class='hs-definition'>ifWindows</span> <span class='hs-varid'>qry</span> <span class='hs-varid'>f</span> <span class='hs-varid'>el</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>withWindowSet</span> <span class='hs-varop'>$</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>wins</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyword'>do</span> <a name="line-73"></a> <span class='hs-varid'>matches</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>filterM</span> <span class='hs-layout'>(</span><span class='hs-varid'>runQuery</span> <span class='hs-varid'>qry</span><span class='hs-layout'>)</span> <span class='hs-varop'>$</span> <span class='hs-conid'>W</span><span class='hs-varop'>.</span><span class='hs-varid'>allWindows</span> <span class='hs-varid'>wins</span> <a name="line-74"></a> <span class='hs-keyword'>case</span> <span class='hs-varid'>matches</span> <span class='hs-keyword'>of</span> <a name="line-75"></a> <span class='hs-conid'>[]</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>el</span> <a name="line-76"></a> <span class='hs-varid'>ws</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>f</span> <span class='hs-varid'>ws</span> <a name="line-77"></a> <a name="line-78"></a><a name="ifWindow"></a><span class='hs-comment'>-- | The same as ifWindows, but applies a ManageHook to the first match</span> <a name="line-79"></a><span class='hs-comment'>-- instead and discards the other matches</span> <a name="line-80"></a><span class='hs-definition'>ifWindow</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Query</span> <span class='hs-conid'>Bool</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>ManageHook</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>X</span> <span class='hs-conid'>()</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>X</span> <span class='hs-conid'>()</span> <a name="line-81"></a><span class='hs-definition'>ifWindow</span> <span class='hs-varid'>qry</span> <span class='hs-varid'>mh</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>ifWindows</span> <span class='hs-varid'>qry</span> <span class='hs-layout'>(</span><span class='hs-varid'>windows</span> <span class='hs-varop'>.</span> <span class='hs-varid'>appEndo</span> <span class='hs-varop'><=<</span> <span class='hs-varid'>runQuery</span> <span class='hs-varid'>mh</span> <span class='hs-varop'>.</span> <span class='hs-varid'>head</span><span class='hs-layout'>)</span> <a name="line-82"></a> <a name="line-83"></a><a name="runOrRaise"></a><span class='hs-comment'>-- | 'action' is an executable to be run via 'safeSpawnProg' (of "XMonad.Util.Run") if the Window cannot be found.</span> <a name="line-84"></a><span class='hs-comment'>-- Presumably this executable is the same one that you were looking for.</span> <a name="line-85"></a><span class='hs-definition'>runOrRaise</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>String</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Query</span> <span class='hs-conid'>Bool</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>X</span> <span class='hs-conid'>()</span> <a name="line-86"></a><span class='hs-definition'>runOrRaise</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>raiseMaybe</span> <span class='hs-varop'>.</span> <span class='hs-varid'>safeSpawnProg</span> <a name="line-87"></a> <a name="line-88"></a><a name="raise"></a><span class='hs-comment'>-- | See 'raiseMaybe'. If the Window can't be found, quietly give up and do nothing.</span> <a name="line-89"></a><span class='hs-definition'>raise</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Query</span> <span class='hs-conid'>Bool</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>X</span> <span class='hs-conid'>()</span> <a name="line-90"></a><span class='hs-definition'>raise</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>raiseMaybe</span> <span class='hs-varop'>$</span> <span class='hs-varid'>return</span> <span class='hs-conid'>()</span> <a name="line-91"></a> <a name="line-92"></a><a name="raiseMaybe"></a><span class='hs-comment'>{- | 'raiseMaybe' queries all Windows based on a boolean provided by the <a name="line-93"></a> user. Currently, there are 3 such useful booleans defined in <a name="line-94"></a> "XMonad.ManageHook": 'title', 'resource', 'className'. Each one tests based pretty <a name="line-95"></a> much as you would think. ManageHook also defines several operators, the most <a name="line-96"></a> useful of which is (=?). So a useful test might be finding a @Window@ whose <a name="line-97"></a> class is Firefox. Firefox 3 declares the class \"Firefox\", so you'd want to <a name="line-98"></a> pass in a boolean like @(className =? \"Firefox\")@. <a name="line-99"></a> <a name="line-100"></a> If the boolean returns @True@ on one or more windows, then XMonad will quickly <a name="line-101"></a> make visible the first result. If no @Window@ meets the criteria, then the <a name="line-102"></a> first argument comes into play. <a name="line-103"></a> <a name="line-104"></a> The first argument is an arbitrary IO function which will be executed if the <a name="line-105"></a> tests fail. This is what enables 'runOrRaise' to use 'raiseMaybe': it simply runs <a name="line-106"></a> the desired program if it isn't found. But you don't have to do that. Maybe <a name="line-107"></a> you want to do nothing if the search fails (the definition of 'raise'), or <a name="line-108"></a> maybe you want to write to a log file, or call some prompt function, or <a name="line-109"></a> something crazy like that. This hook gives you that flexibility. You can do <a name="line-110"></a> some cute things with this hook. Suppose you want to do the same thing for <a name="line-111"></a> Mutt which you just did for Firefox - but Mutt runs inside a terminal window? <a name="line-112"></a> No problem: you search for a terminal window calling itself \"mutt\", and if <a name="line-113"></a> there isn't you run a terminal with a command to run Mutt! Here's an example <a name="line-114"></a> (borrowing 'runInTerm' from "XMonad.Utils.Run"): <a name="line-115"></a> <a name="line-116"></a> > , ((modm, xK_m), raiseMaybe (runInTerm "-title mutt" "mutt") (title =? "mutt")) <a name="line-117"></a>-}</span> <a name="line-118"></a><span class='hs-definition'>raiseMaybe</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>X</span> <span class='hs-conid'>()</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Query</span> <span class='hs-conid'>Bool</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>X</span> <span class='hs-conid'>()</span> <a name="line-119"></a><span class='hs-definition'>raiseMaybe</span> <span class='hs-varid'>f</span> <span class='hs-varid'>qry</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>ifWindow</span> <span class='hs-varid'>qry</span> <span class='hs-varid'>raiseHook</span> <span class='hs-varid'>f</span> <a name="line-120"></a> <a name="line-121"></a><a name="raiseHook"></a><span class='hs-comment'>-- | A manage hook that raises the window.</span> <a name="line-122"></a><span class='hs-definition'>raiseHook</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>ManageHook</span> <a name="line-123"></a><span class='hs-definition'>raiseHook</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>ask</span> <span class='hs-varop'>>>=</span> <span class='hs-varid'>doF</span> <span class='hs-varop'>.</span> <span class='hs-conid'>W</span><span class='hs-varop'>.</span><span class='hs-varid'>focusWindow</span> <a name="line-124"></a> <a name="line-125"></a><a name="runOrRaiseNext"></a><span class='hs-comment'>-- | See 'runOrRaise' and 'raiseNextMaybe'. Version that allows cycling through matches.</span> <a name="line-126"></a><span class='hs-definition'>runOrRaiseNext</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>String</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Query</span> <span class='hs-conid'>Bool</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>X</span> <span class='hs-conid'>()</span> <a name="line-127"></a><span class='hs-definition'>runOrRaiseNext</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>raiseNextMaybe</span> <span class='hs-varop'>.</span> <span class='hs-varid'>safeSpawnProg</span> <a name="line-128"></a> <a name="line-129"></a><a name="raiseNext"></a><span class='hs-comment'>-- | See 'raise' and 'raiseNextMaybe'. Version that allows cycling through matches.</span> <a name="line-130"></a><span class='hs-definition'>raiseNext</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Query</span> <span class='hs-conid'>Bool</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>X</span> <span class='hs-conid'>()</span> <a name="line-131"></a><span class='hs-definition'>raiseNext</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>raiseNextMaybe</span> <span class='hs-varop'>$</span> <span class='hs-varid'>return</span> <span class='hs-conid'>()</span> <a name="line-132"></a> <a name="line-133"></a><span class='hs-comment'>{- | See 'raiseMaybe'. <a name="line-134"></a> 'raiseNextMaybe' is an alternative version that allows cycling <a name="line-135"></a> through the matching windows. If the focused window matches the <a name="line-136"></a> query the next matching window is raised. If no matches are found <a name="line-137"></a> the function f is executed. <a name="line-138"></a>-}</span> <a name="line-139"></a> <a name="line-140"></a><a name="raiseNextMaybe"></a><span class='hs-definition'>raiseNextMaybe</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>X</span> <span class='hs-conid'>()</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Query</span> <span class='hs-conid'>Bool</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>X</span> <span class='hs-conid'>()</span> <a name="line-141"></a><span class='hs-definition'>raiseNextMaybe</span> <span class='hs-varid'>f</span> <span class='hs-varid'>qry</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>flip</span> <span class='hs-layout'>(</span><span class='hs-varid'>ifWindows</span> <span class='hs-varid'>qry</span><span class='hs-layout'>)</span> <span class='hs-varid'>f</span> <span class='hs-varop'>$</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>ws</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyword'>do</span> <a name="line-142"></a> <span class='hs-varid'>foc</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>withWindowSet</span> <span class='hs-varop'>$</span> <span class='hs-varid'>return</span> <span class='hs-varop'>.</span> <span class='hs-conid'>W</span><span class='hs-varop'>.</span><span class='hs-varid'>peek</span> <a name="line-143"></a> <span class='hs-keyword'>case</span> <span class='hs-varid'>foc</span> <span class='hs-keyword'>of</span> <a name="line-144"></a> <span class='hs-conid'>Just</span> <span class='hs-varid'>w</span> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>w</span> <span class='hs-varop'>`elem`</span> <span class='hs-varid'>ws</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyword'>let</span> <span class='hs-layout'>(</span><span class='hs-keyword'>_</span><span class='hs-conop'>:</span><span class='hs-varid'>y</span><span class='hs-conop'>:</span><span class='hs-keyword'>_</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>dropWhile</span> <span class='hs-layout'>(</span><span class='hs-varop'>/=</span><span class='hs-varid'>w</span><span class='hs-layout'>)</span> <span class='hs-varop'>$</span> <span class='hs-varid'>cycle</span> <span class='hs-varid'>ws</span> <span class='hs-comment'>-- cannot fail to match</span> <a name="line-145"></a> <span class='hs-keyword'>in</span> <span class='hs-varid'>windows</span> <span class='hs-varop'>$</span> <span class='hs-conid'>W</span><span class='hs-varop'>.</span><span class='hs-varid'>focusWindow</span> <span class='hs-varid'>y</span> <a name="line-146"></a> <span class='hs-keyword'>_</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>windows</span> <span class='hs-varop'>.</span> <span class='hs-conid'>W</span><span class='hs-varop'>.</span><span class='hs-varid'>focusWindow</span> <span class='hs-varop'>.</span> <span class='hs-varid'>head</span> <span class='hs-varop'>$</span> <span class='hs-varid'>ws</span> <a name="line-147"></a> <a name="line-148"></a><a name="raiseVar"></a><span class='hs-comment'>-- | Given a function which gets us a String, we try to raise a window with that classname,</span> <a name="line-149"></a><span class='hs-comment'>-- or we then interpret that String as a executable name.</span> <a name="line-150"></a><span class='hs-definition'>raiseVar</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>IO</span> <span class='hs-conid'>String</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>X</span> <span class='hs-conid'>()</span> <a name="line-151"></a><span class='hs-definition'>raiseVar</span> <span class='hs-varid'>getvar</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>liftIO</span> <span class='hs-varid'>getvar</span> <span class='hs-varop'>>>=</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>var</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>runOrRaise</span> <span class='hs-varid'>var</span> <span class='hs-layout'>(</span><span class='hs-varid'>fmap</span> <span class='hs-layout'>(</span><span class='hs-varid'>map</span> <span class='hs-varid'>toLower</span><span class='hs-layout'>)</span> <span class='hs-varid'>className</span> <span class='hs-varop'>=?</span> <span class='hs-varid'>var</span><span class='hs-layout'>)</span> <a name="line-152"></a> <a name="line-153"></a><a name="raiseBrowser"></a><span class='hs-comment'>{- | 'raiseBrowser' and 'raiseEditor' grab $BROWSER and $EDITOR respectively and they either <a name="line-154"></a> take you to the specified program's window, or they try to run it. This is most useful <a name="line-155"></a> if your variables are simple and look like \"firefox\" or \"emacs\". -}</span> <a name="line-156"></a><span class='hs-definition'>raiseBrowser</span><span class='hs-layout'>,</span> <span class='hs-varid'>raiseEditor</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>X</span> <span class='hs-conid'>()</span> <a name="line-157"></a><span class='hs-definition'>raiseBrowser</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>raiseVar</span> <span class='hs-varid'>getBrowser</span> <a name="line-158"></a><a name="raiseEditor"></a><span class='hs-definition'>raiseEditor</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>raiseVar</span> <span class='hs-varid'>getEditor</span> <a name="line-159"></a> <a name="line-160"></a><a name="raiseAndDo"></a><span class='hs-comment'>{- | If the window is found the window is focused and the third argument is called <a name="line-161"></a> otherwise, the first argument is called <a name="line-162"></a> See 'raiseMaster' for an example. -}</span> <a name="line-163"></a><span class='hs-definition'>raiseAndDo</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>X</span> <span class='hs-conid'>()</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Query</span> <span class='hs-conid'>Bool</span> <span class='hs-keyglyph'>-></span> <span class='hs-layout'>(</span><span class='hs-conid'>Window</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>X</span> <span class='hs-conid'>()</span><span class='hs-layout'>)</span><span class='hs-keyglyph'>-></span> <span class='hs-conid'>X</span> <span class='hs-conid'>()</span> <a name="line-164"></a><span class='hs-definition'>raiseAndDo</span> <span class='hs-varid'>f</span> <span class='hs-varid'>qry</span> <span class='hs-varid'>after</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>ifWindow</span> <span class='hs-varid'>qry</span> <span class='hs-layout'>(</span><span class='hs-varid'>afterRaise</span> <span class='hs-varop'>`mappend`</span> <span class='hs-varid'>raiseHook</span><span class='hs-layout'>)</span> <span class='hs-varid'>f</span> <a name="line-165"></a> <span class='hs-keyword'>where</span> <span class='hs-varid'>afterRaise</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>ask</span> <span class='hs-varop'>>>=</span> <span class='hs-layout'>(</span><span class='hs-varop'>>></span> <span class='hs-varid'>idHook</span><span class='hs-layout'>)</span> <span class='hs-varop'>.</span> <span class='hs-varid'>liftX</span> <span class='hs-varop'>.</span> <span class='hs-varid'>after</span> <a name="line-166"></a> <a name="line-167"></a><a name="runOrRaiseAndDo"></a><span class='hs-comment'>{- | If a window matching the second arugment is found, the window is focused and the third argument is called; <a name="line-168"></a> otherwise, the first argument is called. -}</span> <a name="line-169"></a><span class='hs-definition'>runOrRaiseAndDo</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>String</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Query</span> <span class='hs-conid'>Bool</span> <span class='hs-keyglyph'>-></span> <span class='hs-layout'>(</span><span class='hs-conid'>Window</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>X</span> <span class='hs-conid'>()</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>X</span> <span class='hs-conid'>()</span> <a name="line-170"></a><span class='hs-definition'>runOrRaiseAndDo</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>raiseAndDo</span> <span class='hs-varop'>.</span> <span class='hs-varid'>safeSpawnProg</span> <a name="line-171"></a> <a name="line-172"></a><a name="raiseMaster"></a><span class='hs-comment'>{- | if the window is found the window is focused and set to master <a name="line-173"></a> otherwise, the first argument is called. <a name="line-174"></a> <a name="line-175"></a> > raiseMaster (runInTerm "-title ghci" "zsh -c 'ghci'") (title =? "ghci") -}</span> <a name="line-176"></a><span class='hs-definition'>raiseMaster</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>X</span> <span class='hs-conid'>()</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Query</span> <span class='hs-conid'>Bool</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>X</span> <span class='hs-conid'>()</span> <a name="line-177"></a><span class='hs-definition'>raiseMaster</span> <span class='hs-varid'>raisef</span> <span class='hs-varid'>thatUserQuery</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>raiseAndDo</span> <span class='hs-varid'>raisef</span> <span class='hs-varid'>thatUserQuery</span> <span class='hs-layout'>(</span><span class='hs-keyglyph'>\</span><span class='hs-keyword'>_</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>windows</span> <span class='hs-conid'>W</span><span class='hs-varop'>.</span><span class='hs-varid'>swapMaster</span><span class='hs-layout'>)</span> <a name="line-178"></a> <a name="line-179"></a><a name="runOrRaiseMaster"></a><span class='hs-comment'>{- | If the window is found the window is focused and set to master <a name="line-180"></a> otherwise, action is run. <a name="line-181"></a> <a name="line-182"></a> > runOrRaiseMaster "firefox" (className =? "Firefox")) <a name="line-183"></a> -}</span> <a name="line-184"></a><span class='hs-definition'>runOrRaiseMaster</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>String</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Query</span> <span class='hs-conid'>Bool</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>X</span> <span class='hs-conid'>()</span> <a name="line-185"></a><span class='hs-definition'>runOrRaiseMaster</span> <span class='hs-varid'>run</span> <span class='hs-varid'>query</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>runOrRaiseAndDo</span> <span class='hs-varid'>run</span> <span class='hs-varid'>query</span> <span class='hs-layout'>(</span><span class='hs-keyglyph'>\</span><span class='hs-keyword'>_</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>windows</span> <span class='hs-conid'>W</span><span class='hs-varop'>.</span><span class='hs-varid'>swapMaster</span><span class='hs-layout'>)</span> </pre></body> </html>