<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>XMonad.Hooks.UrgencyHook</title><link href="ocean.css" rel="stylesheet" type="text/css" title="Ocean" /><script src="haddock-util.js" type="text/javascript"></script><script type="text/javascript">//<![CDATA[
window.onload = function () {pageLoad();setSynopsis("mini_XMonad-Hooks-UrgencyHook.html");};
//]]>
</script></head><body><div id="package-header"><ul class="links" id="page-menu"><li><a href="src/XMonad-Hooks-UrgencyHook.html">Source</a></li><li><a href="index.html">Contents</a></li><li><a href="doc-index.html">Index</a></li></ul><p class="caption">xmonad-contrib-0.11: Third party extensions for xmonad</p></div><div id="content"><div id="module-header"><table class="info"><tr><th>Portability</th><td>unportable</td></tr><tr><th>Stability</th><td>unstable</td></tr><tr><th>Maintainer</th><td>Devin Mullins <me@twifkak.com></td></tr><tr><th>Safe Haskell</th><td>Safe-Infered</td></tr></table><p class="caption">XMonad.Hooks.UrgencyHook</p></div><div id="table-of-contents"><p class="caption">Contents</p><ul><li><a href="#g:1">Usage
</a><ul><li><a href="#g:2">Pop up a temporary dzen
</a></li><li><a href="#g:3">Highlight in existing dzen
</a></li><li><a href="#g:4">Useful keybinding
</a></li><li><a href="#g:5">Note
</a></li></ul></li><li><a href="#g:6">Troubleshooting
</a></li><li><a href="#g:7">Example: Setting up irssi + rxvt-unicode
</a><ul><li><a href="#g:8">Configuring irssi
</a></li><li><a href="#g:9">Configuring screen
</a></li><li><a href="#g:10">Configuring rxvt-unicode
</a></li><li><a href="#g:11">Configuring xmonad
</a></li></ul></li><li><a href="#g:12">Stuff for your config file:
</a></li><li><a href="#g:13">Stuff for developers:
</a></li></ul></div><div id="description"><p class="caption">Description</p><div class="doc"><p>UrgencyHook lets you configure an action to occur when a window demands
your attention. (In traditional WMs, this takes the form of "flashing"
on your "taskbar." Blech.)
</p></div></div><div id="synopsis"><p id="control.syn" class="caption expander" onclick="toggleSection('syn')">Synopsis</p><ul id="section.syn" class="hide" onclick="toggleSection('syn')"><li class="src short"><a href="#v:withUrgencyHook">withUrgencyHook</a> :: (<a href="/usr/share/doc/ghc/html/libraries/xmonad-0.11/XMonad-Core.html#t:LayoutClass">LayoutClass</a> l <a href="/usr/share/doc/ghc/html/libraries/X11-1.6.0/Graphics-X11-Types.html#t:Window">Window</a>, <a href="XMonad-Hooks-UrgencyHook.html#t:UrgencyHook">UrgencyHook</a> h) => h -> <a href="/usr/share/doc/ghc/html/libraries/xmonad-0.11/XMonad-Core.html#t:XConfig">XConfig</a> l -> <a href="/usr/share/doc/ghc/html/libraries/xmonad-0.11/XMonad-Core.html#t:XConfig">XConfig</a> l</li><li class="src short"><a href="#v:withUrgencyHookC">withUrgencyHookC</a> :: (<a href="/usr/share/doc/ghc/html/libraries/xmonad-0.11/XMonad-Core.html#t:LayoutClass">LayoutClass</a> l <a href="/usr/share/doc/ghc/html/libraries/X11-1.6.0/Graphics-X11-Types.html#t:Window">Window</a>, <a href="XMonad-Hooks-UrgencyHook.html#t:UrgencyHook">UrgencyHook</a> h) => h -> <a href="XMonad-Hooks-UrgencyHook.html#t:UrgencyConfig">UrgencyConfig</a> -> <a href="/usr/share/doc/ghc/html/libraries/xmonad-0.11/XMonad-Core.html#t:XConfig">XConfig</a> l -> <a href="/usr/share/doc/ghc/html/libraries/xmonad-0.11/XMonad-Core.html#t:XConfig">XConfig</a> l</li><li class="src short"><span class="keyword">data</span> <a href="#t:UrgencyConfig">UrgencyConfig</a> = <a href="#v:UrgencyConfig">UrgencyConfig</a> {<ul class="subs"><li><a href="#v:suppressWhen">suppressWhen</a> :: <a href="XMonad-Hooks-UrgencyHook.html#t:SuppressWhen">SuppressWhen</a></li><li><a href="#v:remindWhen">remindWhen</a> :: <a href="XMonad-Hooks-UrgencyHook.html#t:RemindWhen">RemindWhen</a></li></ul>}</li><li class="src short"><a href="#v:urgencyConfig">urgencyConfig</a> :: <a href="XMonad-Hooks-UrgencyHook.html#t:UrgencyConfig">UrgencyConfig</a></li><li class="src short"><span class="keyword">data</span> <a href="#t:SuppressWhen">SuppressWhen</a> <ul class="subs"><li>= <a href="#v:Visible">Visible</a> </li><li>| <a href="#v:OnScreen">OnScreen</a> </li><li>| <a href="#v:Focused">Focused</a> </li><li>| <a href="#v:Never">Never</a> </li></ul></li><li class="src short"><span class="keyword">data</span> <a href="#t:RemindWhen">RemindWhen</a> <ul class="subs"><li>= <a href="#v:Dont">Dont</a> </li><li>| <a href="#v:Repeatedly">Repeatedly</a> <a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-Int.html#t:Int">Int</a> <a href="XMonad-Hooks-UrgencyHook.html#t:Interval">Interval</a> </li><li>| <a href="#v:Every">Every</a> <a href="XMonad-Hooks-UrgencyHook.html#t:Interval">Interval</a> </li></ul></li><li class="src short"><a href="#v:focusUrgent">focusUrgent</a> :: <a href="/usr/share/doc/ghc/html/libraries/xmonad-0.11/XMonad-Core.html#t:X">X</a> <a href="/usr/share/doc/ghc/html/libraries/ghc-prim-0.2.0.0/GHC-Tuple.html#t:-40--41-">()</a></li><li class="src short"><a href="#v:clearUrgents">clearUrgents</a> :: <a href="/usr/share/doc/ghc/html/libraries/xmonad-0.11/XMonad-Core.html#t:X">X</a> <a href="/usr/share/doc/ghc/html/libraries/ghc-prim-0.2.0.0/GHC-Tuple.html#t:-40--41-">()</a></li><li class="src short"><a href="#v:dzenUrgencyHook">dzenUrgencyHook</a> :: <a href="XMonad-Hooks-UrgencyHook.html#t:DzenUrgencyHook">DzenUrgencyHook</a></li><li class="src short"><span class="keyword">data</span> <a href="#t:DzenUrgencyHook">DzenUrgencyHook</a> = <a href="#v:DzenUrgencyHook">DzenUrgencyHook</a> {<ul class="subs"><li><a href="#v:duration">duration</a> :: <a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-Int.html#t:Int">Int</a></li><li><a href="#v:args">args</a> :: [<a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-String.html#t:String">String</a>]</li></ul>}</li><li class="src short"><span class="keyword">data</span> <a href="#t:NoUrgencyHook">NoUrgencyHook</a> = <a href="#v:NoUrgencyHook">NoUrgencyHook</a></li><li class="src short"><span class="keyword">data</span> <a href="#t:BorderUrgencyHook">BorderUrgencyHook</a> = <a href="#v:BorderUrgencyHook">BorderUrgencyHook</a> {<ul class="subs"><li><a href="#v:urgencyBorderColor">urgencyBorderColor</a> :: !<a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-String.html#t:String">String</a></li></ul>}</li><li class="src short"><span class="keyword">data</span> <a href="#t:FocusHook">FocusHook</a> = <a href="#v:FocusHook">FocusHook</a></li><li class="src short"><a href="#v:minutes">minutes</a> :: <a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Prelude.html#t:Rational">Rational</a> -> <a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Prelude.html#t:Rational">Rational</a></li><li class="src short"><a href="#v:seconds">seconds</a> :: <a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Prelude.html#t:Rational">Rational</a> -> <a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-Int.html#t:Int">Int</a></li><li class="src short"><a href="#v:readUrgents">readUrgents</a> :: <a href="/usr/share/doc/ghc/html/libraries/xmonad-0.11/XMonad-Core.html#t:X">X</a> [<a href="/usr/share/doc/ghc/html/libraries/X11-1.6.0/Graphics-X11-Types.html#t:Window">Window</a>]</li><li class="src short"><a href="#v:withUrgents">withUrgents</a> :: ([<a href="/usr/share/doc/ghc/html/libraries/X11-1.6.0/Graphics-X11-Types.html#t:Window">Window</a>] -> <a href="/usr/share/doc/ghc/html/libraries/xmonad-0.11/XMonad-Core.html#t:X">X</a> a) -> <a href="/usr/share/doc/ghc/html/libraries/xmonad-0.11/XMonad-Core.html#t:X">X</a> a</li><li class="src short"><span class="keyword">data</span> <a href="#t:StdoutUrgencyHook">StdoutUrgencyHook</a> = <a href="#v:StdoutUrgencyHook">StdoutUrgencyHook</a></li><li class="src short"><span class="keyword">newtype</span> <a href="#t:SpawnUrgencyHook">SpawnUrgencyHook</a> = <a href="#v:SpawnUrgencyHook">SpawnUrgencyHook</a> <a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-String.html#t:String">String</a></li><li class="src short"><span class="keyword">class</span> <a href="#t:UrgencyHook">UrgencyHook</a> h <span class="keyword">where</span><ul class="subs"><li><a href="#v:urgencyHook">urgencyHook</a> :: h -> <a href="/usr/share/doc/ghc/html/libraries/X11-1.6.0/Graphics-X11-Types.html#t:Window">Window</a> -> <a href="/usr/share/doc/ghc/html/libraries/xmonad-0.11/XMonad-Core.html#t:X">X</a> <a href="/usr/share/doc/ghc/html/libraries/ghc-prim-0.2.0.0/GHC-Tuple.html#t:-40--41-">()</a></li></ul></li><li class="src short"><span class="keyword">type</span> <a href="#t:Interval">Interval</a> = <a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Prelude.html#t:Rational">Rational</a></li><li class="src short"><a href="#v:borderUrgencyHook">borderUrgencyHook</a> :: <a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-String.html#t:String">String</a> -> <a href="/usr/share/doc/ghc/html/libraries/X11-1.6.0/Graphics-X11-Types.html#t:Window">Window</a> -> <a href="/usr/share/doc/ghc/html/libraries/xmonad-0.11/XMonad-Core.html#t:X">X</a> <a href="/usr/share/doc/ghc/html/libraries/ghc-prim-0.2.0.0/GHC-Tuple.html#t:-40--41-">()</a></li><li class="src short"><a href="#v:focusHook">focusHook</a> :: <a href="/usr/share/doc/ghc/html/libraries/X11-1.6.0/Graphics-X11-Types.html#t:Window">Window</a> -> <a href="/usr/share/doc/ghc/html/libraries/xmonad-0.11/XMonad-Core.html#t:X">X</a> <a href="/usr/share/doc/ghc/html/libraries/ghc-prim-0.2.0.0/GHC-Tuple.html#t:-40--41-">()</a></li><li class="src short"><a href="#v:spawnUrgencyHook">spawnUrgencyHook</a> :: <a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-String.html#t:String">String</a> -> <a href="/usr/share/doc/ghc/html/libraries/X11-1.6.0/Graphics-X11-Types.html#t:Window">Window</a> -> <a href="/usr/share/doc/ghc/html/libraries/xmonad-0.11/XMonad-Core.html#t:X">X</a> <a href="/usr/share/doc/ghc/html/libraries/ghc-prim-0.2.0.0/GHC-Tuple.html#t:-40--41-">()</a></li><li class="src short"><a href="#v:stdoutUrgencyHook">stdoutUrgencyHook</a> :: <a href="/usr/share/doc/ghc/html/libraries/X11-1.6.0/Graphics-X11-Types.html#t:Window">Window</a> -> <a href="/usr/share/doc/ghc/html/libraries/xmonad-0.11/XMonad-Core.html#t:X">X</a> <a href="/usr/share/doc/ghc/html/libraries/ghc-prim-0.2.0.0/GHC-Tuple.html#t:-40--41-">()</a></li></ul></div><div id="interface"><h1 id="g:1">Usage
</h1><div class="doc"><p>To wire this up, first add:
</p><pre> import XMonad.Hooks.UrgencyHook
</pre><p>to your import list in your config file. Now, you have a decision to make:
When a window deems itself urgent, do you want to pop up a temporary dzen
bar telling you so, or do you have an existing dzen wherein you would like to
highlight urgent workspaces?
</p></div><h2 id="g:2">Pop up a temporary dzen
</h2><div class="doc"><p>Enable your urgency hook by wrapping your config record in a call to
<code><a href="XMonad-Hooks-UrgencyHook.html#v:withUrgencyHook">withUrgencyHook</a></code>. For example:
</p><pre> main = xmonad $ withUrgencyHook dzenUrgencyHook { args = ["-bg", "darkgreen", "-xs", "1"] }
$ defaultConfig
</pre><p>This will pop up a dzen bar for five seconds telling you you've got an
urgent window.
</p></div><h2 id="g:3">Highlight in existing dzen
</h2><div class="doc"><p>In order for xmonad to track urgent windows, you must install an urgency hook.
You can use the above <code><a href="XMonad-Hooks-UrgencyHook.html#v:dzenUrgencyHook">dzenUrgencyHook</a></code>, or if you're not interested in the
extra popup, install NoUrgencyHook, as so:
</p><pre> main = xmonad $ withUrgencyHook NoUrgencyHook
$ defaultConfig
</pre><p>Now, your <a href="XMonad-Hooks-DynamicLog.html">XMonad.Hooks.DynamicLog</a> must be set up to display the urgent
windows. If you're using the <code>dzen</code> or <code>dzenPP</code> functions from that module,
then you should be good. Otherwise, you want to figure out how to set
<code>ppUrgent</code>.
</p></div><h2 id="g:4">Useful keybinding
</h2><div class="doc"><p>You can set up a keybinding to jump to the window that was recently marked
urgent. See an example at <code><a href="XMonad-Hooks-UrgencyHook.html#v:focusUrgent">focusUrgent</a></code>.
</p></div><h2 id="g:5">Note
</h2><div class="doc"><p>Note: UrgencyHook installs itself as a LayoutModifier, so if you modify your
urgency hook and restart xmonad, you may need to rejigger your layout by
hitting mod-shift-space.
</p></div><h1 id="g:6">Troubleshooting
</h1><div class="doc"><p>There are three steps to get right:
</p><ol><li> The X client must set the UrgencyHint flag. How to configure this
depends on the application. If you're using a terminal app, this is in
two parts:
</li></ol><ul><li> The console app must send a ^G (bell). In bash, a helpful trick is
<code>sleep 1; echo -e '\a'</code>.
</li><li> The terminal must convert the bell into UrgencyHint.
</li></ul><ol><li> XMonad must be configured to notice UrgencyHints. If you've added
withUrgencyHook, you may need to hit mod-shift-space to reset the layout.
</li><li> The dzen must run when told. Run <code>dzen2 -help</code> and make sure that it
supports all of the arguments you told DzenUrgencyHook to pass it. Also,
set up a keybinding to the <code>dzen</code> action in <a href="XMonad-Util-Dzen.html">XMonad.Util.Dzen</a> to test
if that works.
</li></ol><p>As best you can, try to isolate which one(s) of those is failing.
</p></div><h1 id="g:7">Example: Setting up irssi + rxvt-unicode
</h1><div class="doc"><p>This is a commonly asked example. By default, the window doesn't get flagged
urgent when somebody messages you in irssi. You will have to configure some
things. If you're using different tools than this, your mileage will almost
certainly vary. (For example, in Xchat2, it's just a simple checkbox.)
</p></div><h2 id="g:8">Configuring irssi
</h2><div class="doc"><p><code>Irssi</code> is not an X11 app, so it can't set the <code>UrgencyHint</code> flag on <code>XWMHints</code>.
However, on all console applications is bestown the greatest of all notification
systems: the bell. That's right, Ctrl+G, ASCII code 7, <code>echo -e '\a'</code>, your
friend, the bell. To configure <code>irssi</code> to send a bell when you receive a message:
</p><pre> /set beep_msg_level MSGS NOTICES INVITES DCC DCCMSGS HILIGHT
</pre><p>Consult your local <code>irssi</code> documentation for more detail.
</p></div><h2 id="g:9">Configuring screen
</h2><div class="doc"><p>A common way to run <code>irssi</code> is within the lovable giant, <code>screen</code>. Some distros
(e.g. Ubuntu) like to configure <code>screen</code> to trample on your poor console
applications -- in particular, to turn bell characters into evil, smelly
"visual bells." To turn this off, add:
</p><pre> vbell off # or remove the existing 'vbell on' line
</pre><p>to your .screenrc, or hit <code>C-a C-g</code> within a running <code>screen</code> session for an
immediate but temporary fix.
</p></div><h2 id="g:10">Configuring rxvt-unicode
</h2><div class="doc"><p>Rubber, meet road. Urxvt is the gateway between console apps and X11. To tell
urxvt to set an <code>UrgencyHint</code> when it receives a bell character, first, have
an urxvt version 8.3 or newer, and second, set the following in your
<code>.Xdefaults</code>:
</p><pre> urxvt.urgentOnBell: true
</pre><p>Depending on your setup, you may need to <code>xrdb</code> that.
</p></div><h2 id="g:11">Configuring xmonad
</h2><div class="doc"><p>Hopefully you already read the section on how to configure xmonad. If not,
hopefully you know where to find it.
</p></div><h1 id="g:12">Stuff for your config file:
</h1><div class="top"><p class="src"><a name="v:withUrgencyHook" class="def">withUrgencyHook</a> :: (<a href="/usr/share/doc/ghc/html/libraries/xmonad-0.11/XMonad-Core.html#t:LayoutClass">LayoutClass</a> l <a href="/usr/share/doc/ghc/html/libraries/X11-1.6.0/Graphics-X11-Types.html#t:Window">Window</a>, <a href="XMonad-Hooks-UrgencyHook.html#t:UrgencyHook">UrgencyHook</a> h) => h -> <a href="/usr/share/doc/ghc/html/libraries/xmonad-0.11/XMonad-Core.html#t:XConfig">XConfig</a> l -> <a href="/usr/share/doc/ghc/html/libraries/xmonad-0.11/XMonad-Core.html#t:XConfig">XConfig</a> l<a href="src/XMonad-Hooks-UrgencyHook.html#withUrgencyHook" class="link">Source</a></p><div class="doc"><p>This is the method to enable an urgency hook. It uses the default
<code><a href="XMonad-Hooks-UrgencyHook.html#v:urgencyConfig">urgencyConfig</a></code> to control behavior. To change this, use <code><a href="XMonad-Hooks-UrgencyHook.html#v:withUrgencyHookC">withUrgencyHookC</a></code>
instead.
</p></div></div><div class="top"><p class="src"><a name="v:withUrgencyHookC" class="def">withUrgencyHookC</a> :: (<a href="/usr/share/doc/ghc/html/libraries/xmonad-0.11/XMonad-Core.html#t:LayoutClass">LayoutClass</a> l <a href="/usr/share/doc/ghc/html/libraries/X11-1.6.0/Graphics-X11-Types.html#t:Window">Window</a>, <a href="XMonad-Hooks-UrgencyHook.html#t:UrgencyHook">UrgencyHook</a> h) => h -> <a href="XMonad-Hooks-UrgencyHook.html#t:UrgencyConfig">UrgencyConfig</a> -> <a href="/usr/share/doc/ghc/html/libraries/xmonad-0.11/XMonad-Core.html#t:XConfig">XConfig</a> l -> <a href="/usr/share/doc/ghc/html/libraries/xmonad-0.11/XMonad-Core.html#t:XConfig">XConfig</a> l<a href="src/XMonad-Hooks-UrgencyHook.html#withUrgencyHookC" class="link">Source</a></p><div class="doc"><p>This lets you modify the defaults set in <code><a href="XMonad-Hooks-UrgencyHook.html#v:urgencyConfig">urgencyConfig</a></code>. An example:
</p><pre> withUrgencyHookC dzenUrgencyHook { ... } urgencyConfig { suppressWhen = Focused }
</pre><p>(Don't type the <code>...</code>, you dolt.) See <code><a href="XMonad-Hooks-UrgencyHook.html#t:UrgencyConfig">UrgencyConfig</a></code> for details on configuration.
</p></div></div><div class="top"><p class="src"><span class="keyword">data</span> <a name="t:UrgencyConfig" class="def">UrgencyConfig</a> <a href="src/XMonad-Hooks-UrgencyHook.html#UrgencyConfig" class="link">Source</a></p><div class="doc"><p>Global configuration, applied to all types of <code><a href="XMonad-Hooks-UrgencyHook.html#t:UrgencyHook">UrgencyHook</a></code>. See
<code><a href="XMonad-Hooks-UrgencyHook.html#v:urgencyConfig">urgencyConfig</a></code> for the defaults.
</p></div><div class="subs constructors"><p class="caption">Constructors</p><table><tr><td class="src"><a name="v:UrgencyConfig" class="def">UrgencyConfig</a></td><td class="doc empty"> </td></tr><tr><td colspan="2"><div class="subs fields"><p class="caption">Fields</p><dl><dt class="src"><a name="v:suppressWhen" class="def">suppressWhen</a> :: <a href="XMonad-Hooks-UrgencyHook.html#t:SuppressWhen">SuppressWhen</a></dt><dd class="doc"><p>when to trigger the urgency hook
</p></dd><dt class="src"><a name="v:remindWhen" class="def">remindWhen</a> :: <a href="XMonad-Hooks-UrgencyHook.html#t:RemindWhen">RemindWhen</a></dt><dd class="doc"><p>when to re-trigger the urgency hook
</p></dd></dl><div class="clear"></div></div></td></tr></table></div><div class="subs instances"><p id="control.i:UrgencyConfig" class="caption collapser" onclick="toggleSection('i:UrgencyConfig')">Instances</p><div id="section.i:UrgencyConfig" class="show"><table><tr><td class="src"><a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Text-Read.html#t:Read">Read</a> <a href="XMonad-Hooks-UrgencyHook.html#t:UrgencyConfig">UrgencyConfig</a></td><td class="doc empty"> </td></tr><tr><td class="src"><a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Text-Show.html#t:Show">Show</a> <a href="XMonad-Hooks-UrgencyHook.html#t:UrgencyConfig">UrgencyConfig</a></td><td class="doc empty"> </td></tr></table></div></div></div><div class="top"><p class="src"><a name="v:urgencyConfig" class="def">urgencyConfig</a> :: <a href="XMonad-Hooks-UrgencyHook.html#t:UrgencyConfig">UrgencyConfig</a><a href="src/XMonad-Hooks-UrgencyHook.html#urgencyConfig" class="link">Source</a></p><div class="doc"><p>The default <code><a href="XMonad-Hooks-UrgencyHook.html#t:UrgencyConfig">UrgencyConfig</a></code>. suppressWhen = Visible, remindWhen = Dont.
Use a variation of this in your config just as you use a variation of
defaultConfig for your xmonad definition.
</p></div></div><div class="top"><p class="src"><span class="keyword">data</span> <a name="t:SuppressWhen" class="def">SuppressWhen</a> <a href="src/XMonad-Hooks-UrgencyHook.html#SuppressWhen" class="link">Source</a></p><div class="doc"><p>A set of choices as to <em>when</em> you should (or rather, shouldn't) be notified of an urgent window.
The default is <code><a href="XMonad-Hooks-UrgencyHook.html#v:Visible">Visible</a></code>. Prefix each of the following with "don't bug me when":
</p></div><div class="subs constructors"><p class="caption">Constructors</p><table><tr><td class="src"><a name="v:Visible" class="def">Visible</a></td><td class="doc"><p>the window is currently visible
</p></td></tr><tr><td class="src"><a name="v:OnScreen" class="def">OnScreen</a></td><td class="doc"><p>the window is on the currently focused physical screen
</p></td></tr><tr><td class="src"><a name="v:Focused" class="def">Focused</a></td><td class="doc"><p>the window is currently focused
</p></td></tr><tr><td class="src"><a name="v:Never" class="def">Never</a></td><td class="doc"><p>... aww, heck, go ahead and bug me, just in case.
</p></td></tr></table></div><div class="subs instances"><p id="control.i:SuppressWhen" class="caption collapser" onclick="toggleSection('i:SuppressWhen')">Instances</p><div id="section.i:SuppressWhen" class="show"><table><tr><td class="src"><a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Text-Read.html#t:Read">Read</a> <a href="XMonad-Hooks-UrgencyHook.html#t:SuppressWhen">SuppressWhen</a></td><td class="doc empty"> </td></tr><tr><td class="src"><a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Text-Show.html#t:Show">Show</a> <a href="XMonad-Hooks-UrgencyHook.html#t:SuppressWhen">SuppressWhen</a></td><td class="doc empty"> </td></tr></table></div></div></div><div class="top"><p class="src"><span class="keyword">data</span> <a name="t:RemindWhen" class="def">RemindWhen</a> <a href="src/XMonad-Hooks-UrgencyHook.html#RemindWhen" class="link">Source</a></p><div class="doc"><p>A set of choices as to when you want to be re-notified of an urgent
window. Perhaps you focused on something and you miss the dzen popup bar. Or
you're AFK. Or you feel the need to be more distracted. I don't care.
</p><p>The interval arguments are in seconds. See the <code><a href="XMonad-Hooks-UrgencyHook.html#v:minutes">minutes</a></code> helper.
</p></div><div class="subs constructors"><p class="caption">Constructors</p><table><tr><td class="src"><a name="v:Dont" class="def">Dont</a></td><td class="doc"><p>triggering once is enough
</p></td></tr><tr><td class="src"><a name="v:Repeatedly" class="def">Repeatedly</a> <a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-Int.html#t:Int">Int</a> <a href="XMonad-Hooks-UrgencyHook.html#t:Interval">Interval</a></td><td class="doc"><p>repeat <a href="arg1">arg1</a> times every <a href="arg2">arg2</a> seconds
</p></td></tr><tr><td class="src"><a name="v:Every" class="def">Every</a> <a href="XMonad-Hooks-UrgencyHook.html#t:Interval">Interval</a></td><td class="doc"><p>repeat every <a href="arg1">arg1</a> until the urgency hint is cleared
</p></td></tr></table></div><div class="subs instances"><p id="control.i:RemindWhen" class="caption collapser" onclick="toggleSection('i:RemindWhen')">Instances</p><div id="section.i:RemindWhen" class="show"><table><tr><td class="src"><a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Text-Read.html#t:Read">Read</a> <a href="XMonad-Hooks-UrgencyHook.html#t:RemindWhen">RemindWhen</a></td><td class="doc empty"> </td></tr><tr><td class="src"><a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Text-Show.html#t:Show">Show</a> <a href="XMonad-Hooks-UrgencyHook.html#t:RemindWhen">RemindWhen</a></td><td class="doc empty"> </td></tr></table></div></div></div><div class="top"><p class="src"><a name="v:focusUrgent" class="def">focusUrgent</a> :: <a href="/usr/share/doc/ghc/html/libraries/xmonad-0.11/XMonad-Core.html#t:X">X</a> <a href="/usr/share/doc/ghc/html/libraries/ghc-prim-0.2.0.0/GHC-Tuple.html#t:-40--41-">()</a><a href="src/XMonad-Hooks-UrgencyHook.html#focusUrgent" class="link">Source</a></p><div class="doc"><p>Focuses the most recently urgent window. Good for what ails ya -- I mean, your keybindings.
Example keybinding:
</p><pre> , ((modm , xK_BackSpace), focusUrgent)
</pre></div></div><div class="top"><p class="src"><a name="v:clearUrgents" class="def">clearUrgents</a> :: <a href="/usr/share/doc/ghc/html/libraries/xmonad-0.11/XMonad-Core.html#t:X">X</a> <a href="/usr/share/doc/ghc/html/libraries/ghc-prim-0.2.0.0/GHC-Tuple.html#t:-40--41-">()</a><a href="src/XMonad-Hooks-UrgencyHook.html#clearUrgents" class="link">Source</a></p><div class="doc"><p>Just makes the urgents go away.
Example keybinding:
</p><pre> , ((modm .|. shiftMask, xK_BackSpace), clearUrgents)
</pre></div></div><div class="top"><p class="src"><a name="v:dzenUrgencyHook" class="def">dzenUrgencyHook</a> :: <a href="XMonad-Hooks-UrgencyHook.html#t:DzenUrgencyHook">DzenUrgencyHook</a><a href="src/XMonad-Hooks-UrgencyHook.html#dzenUrgencyHook" class="link">Source</a></p><div class="doc"><p>Flashes when a window requests your attention and you can't see it.
Defaults to a duration of five seconds, and no extra args to dzen.
See <code><a href="XMonad-Hooks-UrgencyHook.html#t:DzenUrgencyHook">DzenUrgencyHook</a></code>.
</p></div></div><div class="top"><p class="src"><span class="keyword">data</span> <a name="t:DzenUrgencyHook" class="def">DzenUrgencyHook</a> <a href="src/XMonad-Hooks-UrgencyHook.html#DzenUrgencyHook" class="link">Source</a></p><div class="doc"><p>Your set of options for configuring a dzenUrgencyHook.
</p></div><div class="subs constructors"><p class="caption">Constructors</p><table><tr><td class="src"><a name="v:DzenUrgencyHook" class="def">DzenUrgencyHook</a></td><td class="doc empty"> </td></tr><tr><td colspan="2"><div class="subs fields"><p class="caption">Fields</p><dl><dt class="src"><a name="v:duration" class="def">duration</a> :: <a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-Int.html#t:Int">Int</a></dt><dd class="doc"><p>number of microseconds to display the dzen
(hence, you'll probably want to use <code><a href="XMonad-Hooks-UrgencyHook.html#v:seconds">seconds</a></code>)
</p></dd><dt class="src"><a name="v:args" class="def">args</a> :: [<a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-String.html#t:String">String</a>]</dt><dd class="doc"><p>list of extra args (as <code><a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-String.html#t:String">String</a></code>s) to pass to dzen
</p></dd></dl><div class="clear"></div></div></td></tr></table></div><div class="subs instances"><p id="control.i:DzenUrgencyHook" class="caption collapser" onclick="toggleSection('i:DzenUrgencyHook')">Instances</p><div id="section.i:DzenUrgencyHook" class="show"><table><tr><td class="src"><a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Text-Read.html#t:Read">Read</a> <a href="XMonad-Hooks-UrgencyHook.html#t:DzenUrgencyHook">DzenUrgencyHook</a></td><td class="doc empty"> </td></tr><tr><td class="src"><a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Text-Show.html#t:Show">Show</a> <a href="XMonad-Hooks-UrgencyHook.html#t:DzenUrgencyHook">DzenUrgencyHook</a></td><td class="doc empty"> </td></tr><tr><td class="src"><a href="XMonad-Hooks-UrgencyHook.html#t:UrgencyHook">UrgencyHook</a> <a href="XMonad-Hooks-UrgencyHook.html#t:DzenUrgencyHook">DzenUrgencyHook</a></td><td class="doc empty"> </td></tr></table></div></div></div><div class="top"><p class="src"><span class="keyword">data</span> <a name="t:NoUrgencyHook" class="def">NoUrgencyHook</a> <a href="src/XMonad-Hooks-UrgencyHook.html#NoUrgencyHook" class="link">Source</a></p><div class="subs constructors"><p class="caption">Constructors</p><table><tr><td class="src"><a name="v:NoUrgencyHook" class="def">NoUrgencyHook</a></td><td class="doc empty"> </td></tr></table></div><div class="subs instances"><p id="control.i:NoUrgencyHook" class="caption collapser" onclick="toggleSection('i:NoUrgencyHook')">Instances</p><div id="section.i:NoUrgencyHook" class="show"><table><tr><td class="src"><a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Text-Read.html#t:Read">Read</a> <a href="XMonad-Hooks-UrgencyHook.html#t:NoUrgencyHook">NoUrgencyHook</a></td><td class="doc empty"> </td></tr><tr><td class="src"><a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Text-Show.html#t:Show">Show</a> <a href="XMonad-Hooks-UrgencyHook.html#t:NoUrgencyHook">NoUrgencyHook</a></td><td class="doc empty"> </td></tr><tr><td class="src"><a href="XMonad-Hooks-UrgencyHook.html#t:UrgencyHook">UrgencyHook</a> <a href="XMonad-Hooks-UrgencyHook.html#t:NoUrgencyHook">NoUrgencyHook</a></td><td class="doc empty"> </td></tr></table></div></div></div><div class="top"><p class="src"><span class="keyword">data</span> <a name="t:BorderUrgencyHook" class="def">BorderUrgencyHook</a> <a href="src/XMonad-Hooks-UrgencyHook.html#BorderUrgencyHook" class="link">Source</a></p><div class="subs constructors"><p class="caption">Constructors</p><table><tr><td class="src"><a name="v:BorderUrgencyHook" class="def">BorderUrgencyHook</a></td><td class="doc empty"> </td></tr><tr><td colspan="2"><div class="subs fields"><p class="caption">Fields</p><dl><dt class="src"><a name="v:urgencyBorderColor" class="def">urgencyBorderColor</a> :: !<a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-String.html#t:String">String</a></dt><dd class="doc empty"> </dd></dl><div class="clear"></div></div></td></tr></table></div><div class="subs instances"><p id="control.i:BorderUrgencyHook" class="caption collapser" onclick="toggleSection('i:BorderUrgencyHook')">Instances</p><div id="section.i:BorderUrgencyHook" class="show"><table><tr><td class="src"><a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Text-Read.html#t:Read">Read</a> <a href="XMonad-Hooks-UrgencyHook.html#t:BorderUrgencyHook">BorderUrgencyHook</a></td><td class="doc empty"> </td></tr><tr><td class="src"><a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Text-Show.html#t:Show">Show</a> <a href="XMonad-Hooks-UrgencyHook.html#t:BorderUrgencyHook">BorderUrgencyHook</a></td><td class="doc empty"> </td></tr><tr><td class="src"><a href="XMonad-Hooks-UrgencyHook.html#t:UrgencyHook">UrgencyHook</a> <a href="XMonad-Hooks-UrgencyHook.html#t:BorderUrgencyHook">BorderUrgencyHook</a></td><td class="doc empty"> </td></tr></table></div></div></div><div class="top"><p class="src"><span class="keyword">data</span> <a name="t:FocusHook" class="def">FocusHook</a> <a href="src/XMonad-Hooks-UrgencyHook.html#FocusHook" class="link">Source</a></p><div class="subs constructors"><p class="caption">Constructors</p><table><tr><td class="src"><a name="v:FocusHook" class="def">FocusHook</a></td><td class="doc empty"> </td></tr></table></div><div class="subs instances"><p id="control.i:FocusHook" class="caption collapser" onclick="toggleSection('i:FocusHook')">Instances</p><div id="section.i:FocusHook" class="show"><table><tr><td class="src"><a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Text-Read.html#t:Read">Read</a> <a href="XMonad-Hooks-UrgencyHook.html#t:FocusHook">FocusHook</a></td><td class="doc empty"> </td></tr><tr><td class="src"><a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Text-Show.html#t:Show">Show</a> <a href="XMonad-Hooks-UrgencyHook.html#t:FocusHook">FocusHook</a></td><td class="doc empty"> </td></tr><tr><td class="src"><a href="XMonad-Hooks-UrgencyHook.html#t:UrgencyHook">UrgencyHook</a> <a href="XMonad-Hooks-UrgencyHook.html#t:FocusHook">FocusHook</a></td><td class="doc empty"> </td></tr></table></div></div></div><div class="top"><p class="src"><a name="v:minutes" class="def">minutes</a> :: <a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Prelude.html#t:Rational">Rational</a> -> <a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Prelude.html#t:Rational">Rational</a><a href="src/XMonad-Hooks-UrgencyHook.html#minutes" class="link">Source</a></p><div class="doc"><p>A prettified way of multiplying by 60. Use like: <code>(5 <code><a href="XMonad-Hooks-UrgencyHook.html#v:minutes">minutes</a></code>)</code>.
</p></div></div><div class="top"><p class="src"><a name="v:seconds" class="def">seconds</a> :: <a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Prelude.html#t:Rational">Rational</a> -> <a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-Int.html#t:Int">Int</a><a href="src/XMonad-Util-Run.html#seconds" class="link">Source</a></p><div class="doc"><p>Multiplies by ONE MILLION, for functions that take microseconds.
</p><p>Use like:
</p><pre> (5.5 `seconds`)
</pre><p>In GHC 7 and later, you must either enable the PostfixOperators extension
(by adding
</p><pre> {-# LANGUAGE PostfixOperators #-}
</pre><p>to the top of your file) or use seconds in prefix form:
</p><pre> 5.5 seconds
</pre></div></div><h1 id="g:13">Stuff for developers:
</h1><div class="top"><p class="src"><a name="v:readUrgents" class="def">readUrgents</a> :: <a href="/usr/share/doc/ghc/html/libraries/xmonad-0.11/XMonad-Core.html#t:X">X</a> [<a href="/usr/share/doc/ghc/html/libraries/X11-1.6.0/Graphics-X11-Types.html#t:Window">Window</a>]<a href="src/XMonad-Hooks-UrgencyHook.html#readUrgents" class="link">Source</a></p><div class="doc"><p>X action that returns a list of currently urgent windows. You might use
it, or <code><a href="XMonad-Hooks-UrgencyHook.html#v:withUrgents">withUrgents</a></code>, in your custom logHook, to display the workspaces that
contain urgent windows.
</p></div></div><div class="top"><p class="src"><a name="v:withUrgents" class="def">withUrgents</a> :: ([<a href="/usr/share/doc/ghc/html/libraries/X11-1.6.0/Graphics-X11-Types.html#t:Window">Window</a>] -> <a href="/usr/share/doc/ghc/html/libraries/xmonad-0.11/XMonad-Core.html#t:X">X</a> a) -> <a href="/usr/share/doc/ghc/html/libraries/xmonad-0.11/XMonad-Core.html#t:X">X</a> a<a href="src/XMonad-Hooks-UrgencyHook.html#withUrgents" class="link">Source</a></p><div class="doc"><p>An HOF version of <code><a href="XMonad-Hooks-UrgencyHook.html#v:readUrgents">readUrgents</a></code>, for those who prefer that sort of thing.
</p></div></div><div class="top"><p class="src"><span class="keyword">data</span> <a name="t:StdoutUrgencyHook" class="def">StdoutUrgencyHook</a> <a href="src/XMonad-Hooks-UrgencyHook.html#StdoutUrgencyHook" class="link">Source</a></p><div class="subs constructors"><p class="caption">Constructors</p><table><tr><td class="src"><a name="v:StdoutUrgencyHook" class="def">StdoutUrgencyHook</a></td><td class="doc empty"> </td></tr></table></div><div class="subs instances"><p id="control.i:StdoutUrgencyHook" class="caption collapser" onclick="toggleSection('i:StdoutUrgencyHook')">Instances</p><div id="section.i:StdoutUrgencyHook" class="show"><table><tr><td class="src"><a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Text-Read.html#t:Read">Read</a> <a href="XMonad-Hooks-UrgencyHook.html#t:StdoutUrgencyHook">StdoutUrgencyHook</a></td><td class="doc empty"> </td></tr><tr><td class="src"><a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Text-Show.html#t:Show">Show</a> <a href="XMonad-Hooks-UrgencyHook.html#t:StdoutUrgencyHook">StdoutUrgencyHook</a></td><td class="doc empty"> </td></tr><tr><td class="src"><a href="XMonad-Hooks-UrgencyHook.html#t:UrgencyHook">UrgencyHook</a> <a href="XMonad-Hooks-UrgencyHook.html#t:StdoutUrgencyHook">StdoutUrgencyHook</a></td><td class="doc empty"> </td></tr></table></div></div></div><div class="top"><p class="src"><span class="keyword">newtype</span> <a name="t:SpawnUrgencyHook" class="def">SpawnUrgencyHook</a> <a href="src/XMonad-Hooks-UrgencyHook.html#SpawnUrgencyHook" class="link">Source</a></p><div class="subs constructors"><p class="caption">Constructors</p><table><tr><td class="src"><a name="v:SpawnUrgencyHook" class="def">SpawnUrgencyHook</a> <a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-String.html#t:String">String</a></td><td class="doc empty"> </td></tr></table></div><div class="subs instances"><p id="control.i:SpawnUrgencyHook" class="caption collapser" onclick="toggleSection('i:SpawnUrgencyHook')">Instances</p><div id="section.i:SpawnUrgencyHook" class="show"><table><tr><td class="src"><a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Text-Read.html#t:Read">Read</a> <a href="XMonad-Hooks-UrgencyHook.html#t:SpawnUrgencyHook">SpawnUrgencyHook</a></td><td class="doc empty"> </td></tr><tr><td class="src"><a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Text-Show.html#t:Show">Show</a> <a href="XMonad-Hooks-UrgencyHook.html#t:SpawnUrgencyHook">SpawnUrgencyHook</a></td><td class="doc empty"> </td></tr><tr><td class="src"><a href="XMonad-Hooks-UrgencyHook.html#t:UrgencyHook">UrgencyHook</a> <a href="XMonad-Hooks-UrgencyHook.html#t:SpawnUrgencyHook">SpawnUrgencyHook</a></td><td class="doc empty"> </td></tr></table></div></div></div><div class="top"><p class="src"><span class="keyword">class</span> <a name="t:UrgencyHook" class="def">UrgencyHook</a> h <span class="keyword">where</span><a href="src/XMonad-Hooks-UrgencyHook.html#UrgencyHook" class="link">Source</a></p><div class="doc"><p>The class definition, and some pre-defined instances.
</p></div><div class="subs methods"><p class="caption">Methods</p><p class="src"><a name="v:urgencyHook" class="def">urgencyHook</a> :: h -> <a href="/usr/share/doc/ghc/html/libraries/X11-1.6.0/Graphics-X11-Types.html#t:Window">Window</a> -> <a href="/usr/share/doc/ghc/html/libraries/xmonad-0.11/XMonad-Core.html#t:X">X</a> <a href="/usr/share/doc/ghc/html/libraries/ghc-prim-0.2.0.0/GHC-Tuple.html#t:-40--41-">()</a><a href="src/XMonad-Hooks-UrgencyHook.html#urgencyHook" class="link">Source</a></p></div><div class="subs instances"><p id="control.i:UrgencyHook" class="caption collapser" onclick="toggleSection('i:UrgencyHook')">Instances</p><div id="section.i:UrgencyHook" class="show"><table><tr><td class="src"><a href="XMonad-Hooks-UrgencyHook.html#t:UrgencyHook">UrgencyHook</a> <a href="XMonad-Hooks-UrgencyHook.html#t:StdoutUrgencyHook">StdoutUrgencyHook</a></td><td class="doc empty"> </td></tr><tr><td class="src"><a href="XMonad-Hooks-UrgencyHook.html#t:UrgencyHook">UrgencyHook</a> <a href="XMonad-Hooks-UrgencyHook.html#t:SpawnUrgencyHook">SpawnUrgencyHook</a></td><td class="doc empty"> </td></tr><tr><td class="src"><a href="XMonad-Hooks-UrgencyHook.html#t:UrgencyHook">UrgencyHook</a> <a href="XMonad-Hooks-UrgencyHook.html#t:BorderUrgencyHook">BorderUrgencyHook</a></td><td class="doc empty"> </td></tr><tr><td class="src"><a href="XMonad-Hooks-UrgencyHook.html#t:UrgencyHook">UrgencyHook</a> <a href="XMonad-Hooks-UrgencyHook.html#t:FocusHook">FocusHook</a></td><td class="doc empty"> </td></tr><tr><td class="src"><a href="XMonad-Hooks-UrgencyHook.html#t:UrgencyHook">UrgencyHook</a> <a href="XMonad-Hooks-UrgencyHook.html#t:DzenUrgencyHook">DzenUrgencyHook</a></td><td class="doc empty"> </td></tr><tr><td class="src"><a href="XMonad-Hooks-UrgencyHook.html#t:UrgencyHook">UrgencyHook</a> <a href="XMonad-Hooks-UrgencyHook.html#t:NoUrgencyHook">NoUrgencyHook</a></td><td class="doc empty"> </td></tr><tr><td class="src"><a href="XMonad-Hooks-UrgencyHook.html#t:UrgencyHook">UrgencyHook</a> (<a href="/usr/share/doc/ghc/html/libraries/X11-1.6.0/Graphics-X11-Types.html#t:Window">Window</a> -> <a href="/usr/share/doc/ghc/html/libraries/xmonad-0.11/XMonad-Core.html#t:X">X</a> ())</td><td class="doc empty"> </td></tr></table></div></div></div><div class="top"><p class="src"><span class="keyword">type</span> <a name="t:Interval" class="def">Interval</a> = <a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Prelude.html#t:Rational">Rational</a><a href="src/XMonad-Hooks-UrgencyHook.html#Interval" class="link">Source</a></p></div><div class="top"><p class="src"><a name="v:borderUrgencyHook" class="def">borderUrgencyHook</a> :: <a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-String.html#t:String">String</a> -> <a href="/usr/share/doc/ghc/html/libraries/X11-1.6.0/Graphics-X11-Types.html#t:Window">Window</a> -> <a href="/usr/share/doc/ghc/html/libraries/xmonad-0.11/XMonad-Core.html#t:X">X</a> <a href="/usr/share/doc/ghc/html/libraries/ghc-prim-0.2.0.0/GHC-Tuple.html#t:-40--41-">()</a><a href="src/XMonad-Hooks-UrgencyHook.html#borderUrgencyHook" class="link">Source</a></p><div class="doc"><p>A hook that sets the border color of an urgent window. The color
will remain until the next time the window gains or loses focus, at
which point the standard border color from the XConfig will be applied.
You may want to use suppressWhen = Never with this:
</p><pre> withUrgencyHookC BorderUrgencyHook { urgencyBorderColor = "#ff0000" } urgencyConfig { suppressWhen = Never } ...
</pre><p>(This should be <code>urgentBorderColor</code> but that breaks <a href="XMonad-Layout-Decoration.html">XMonad.Layout.Decoration</a>.
<code>borderColor</code> breaks anyone using <code>XPConfig</code> from <a href="XMonad-Prompt.html">XMonad.Prompt</a>. We need to
think a bit more about namespacing issues, maybe.)
</p></div></div><div class="top"><p class="src"><a name="v:focusHook" class="def">focusHook</a> :: <a href="/usr/share/doc/ghc/html/libraries/X11-1.6.0/Graphics-X11-Types.html#t:Window">Window</a> -> <a href="/usr/share/doc/ghc/html/libraries/xmonad-0.11/XMonad-Core.html#t:X">X</a> <a href="/usr/share/doc/ghc/html/libraries/ghc-prim-0.2.0.0/GHC-Tuple.html#t:-40--41-">()</a><a href="src/XMonad-Hooks-UrgencyHook.html#focusHook" class="link">Source</a></p><div class="doc"><p>A hook which will automatically send you to anything which sets the urgent
flag (as opposed to printing some sort of message. You would use this as
usual, eg.
</p><pre> withUrgencyHook FocusHook $ myconfig { ...
</pre></div></div><div class="top"><p class="src"><a name="v:spawnUrgencyHook" class="def">spawnUrgencyHook</a> :: <a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-String.html#t:String">String</a> -> <a href="/usr/share/doc/ghc/html/libraries/X11-1.6.0/Graphics-X11-Types.html#t:Window">Window</a> -> <a href="/usr/share/doc/ghc/html/libraries/xmonad-0.11/XMonad-Core.html#t:X">X</a> <a href="/usr/share/doc/ghc/html/libraries/ghc-prim-0.2.0.0/GHC-Tuple.html#t:-40--41-">()</a><a href="src/XMonad-Hooks-UrgencyHook.html#spawnUrgencyHook" class="link">Source</a></p><div class="doc"><p>Spawn a commandline thing, appending the window id to the prefix string
you provide. (Make sure to add a space if you need it.) Do your crazy
xcompmgr thing.
</p></div></div><div class="top"><p class="src"><a name="v:stdoutUrgencyHook" class="def">stdoutUrgencyHook</a> :: <a href="/usr/share/doc/ghc/html/libraries/X11-1.6.0/Graphics-X11-Types.html#t:Window">Window</a> -> <a href="/usr/share/doc/ghc/html/libraries/xmonad-0.11/XMonad-Core.html#t:X">X</a> <a href="/usr/share/doc/ghc/html/libraries/ghc-prim-0.2.0.0/GHC-Tuple.html#t:-40--41-">()</a><a href="src/XMonad-Hooks-UrgencyHook.html#stdoutUrgencyHook" class="link">Source</a></p><div class="doc"><p>For debugging purposes, really.
</p></div></div></div></div><div id="footer"><p>Produced by <a href="http://www.haskell.org/haddock/">Haddock</a> version 2.10.0</p></div></body></html>
