<?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://code.haskell.org/~malcolm/hscolour/ --> <title>XMonad/Prompt/Man.hs</title> <link type='text/css' rel='stylesheet' href='hscolour.css' /> </head> <body> <pre><a name="line-1"></a><span class='hs-comment'>-----------------------------------------------------------------------------</span> <a name="line-2"></a><span class='hs-comment'>-- |</span> <a name="line-3"></a><span class='hs-comment'>-- Module : XMonad.Prompt.Man</span> <a name="line-4"></a><span class='hs-comment'>-- Copyright : (c) 2007 Valery V. Vorotyntsev</span> <a name="line-5"></a><span class='hs-comment'>-- License : BSD3-style (see LICENSE)</span> <a name="line-6"></a><span class='hs-comment'>--</span> <a name="line-7"></a><span class='hs-comment'>-- Maintainer : Valery V. Vorotyntsev <valery.vv@gmail.com></span> <a name="line-8"></a><span class='hs-comment'>-- Portability : non-portable (uses "manpath" and "bash")</span> <a name="line-9"></a><span class='hs-comment'>--</span> <a name="line-10"></a><span class='hs-comment'>-- A manual page prompt for XMonad window manager.</span> <a name="line-11"></a><span class='hs-comment'>--</span> <a name="line-12"></a><span class='hs-comment'>-- TODO</span> <a name="line-13"></a><span class='hs-comment'>--</span> <a name="line-14"></a><span class='hs-comment'>-- * narrow completions by section number, if the one is specified</span> <a name="line-15"></a><span class='hs-comment'>-- (like @\/etc\/bash_completion@ does)</span> <a name="line-16"></a><span class='hs-comment'>-----------------------------------------------------------------------------</span> <a name="line-17"></a> <a name="line-18"></a><span class='hs-keyword'>module</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'>Man</span> <span class='hs-layout'>(</span> <a name="line-19"></a> <span class='hs-comment'>-- * Usage</span> <a name="line-20"></a> <span class='hs-comment'>-- $usage</span> <a name="line-21"></a> <span class='hs-varid'>manPrompt</span> <a name="line-22"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>getCommandOutput</span> <a name="line-23"></a> <span class='hs-layout'>)</span> <span class='hs-keyword'>where</span> <a name="line-24"></a> <a name="line-25"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>XMonad</span> <a name="line-26"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>XMonad</span><span class='hs-varop'>.</span><span class='hs-conid'>Prompt</span> <a name="line-27"></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> <a name="line-28"></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'>split</span><span class='hs-layout'>)</span> <a name="line-29"></a> <a name="line-30"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>System</span><span class='hs-varop'>.</span><span class='hs-conid'>Directory</span> <a name="line-31"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>System</span><span class='hs-varop'>.</span><span class='hs-conid'>Process</span> <a name="line-32"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>System</span><span class='hs-varop'>.</span><span class='hs-conid'>IO</span> <a name="line-33"></a> <a name="line-34"></a><span class='hs-keyword'>import</span> <span class='hs-keyword'>qualified</span> <span class='hs-conid'>Control</span><span class='hs-varop'>.</span><span class='hs-conid'>Exception</span><span class='hs-varop'>.</span><span class='hs-conid'>Extensible</span> <span class='hs-keyword'>as</span> <span class='hs-conid'>E</span> <a name="line-35"></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-36"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>List</span> <a name="line-37"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>Maybe</span> <a name="line-38"></a> <a name="line-39"></a><span class='hs-comment'>-- $usage</span> <a name="line-40"></a><span class='hs-comment'>-- 1. In your @~\/.xmonad\/xmonad.hs@:</span> <a name="line-41"></a><span class='hs-comment'>--</span> <a name="line-42"></a><span class='hs-comment'>-- > import XMonad.Prompt</span> <a name="line-43"></a><span class='hs-comment'>-- > import XMonad.Prompt.Man</span> <a name="line-44"></a><span class='hs-comment'>--</span> <a name="line-45"></a><span class='hs-comment'>-- 2. In your keybindings add something like:</span> <a name="line-46"></a><span class='hs-comment'>--</span> <a name="line-47"></a><span class='hs-comment'>-- > , ((modm, xK_F1), manPrompt defaultXPConfig)</span> <a name="line-48"></a><span class='hs-comment'>--</span> <a name="line-49"></a><span class='hs-comment'>-- For detailed instruction on editing the key binding see</span> <a name="line-50"></a><span class='hs-comment'>-- "XMonad.Doc.Extending#Editing_key_bindings".</span> <a name="line-51"></a> <a name="line-52"></a><a name="Man"></a><span class='hs-keyword'>data</span> <span class='hs-conid'>Man</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Man</span> <a name="line-53"></a> <a name="line-54"></a><span class='hs-keyword'>instance</span> <span class='hs-conid'>XPrompt</span> <span class='hs-conid'>Man</span> <span class='hs-keyword'>where</span> <a name="line-55"></a> <span class='hs-varid'>showXPrompt</span> <span class='hs-conid'>Man</span> <span class='hs-keyglyph'>=</span> <span class='hs-str'>"Manual page: "</span> <a name="line-56"></a> <a name="line-57"></a><a name="manPrompt"></a><span class='hs-comment'>-- | Query for manual page to be displayed.</span> <a name="line-58"></a><span class='hs-definition'>manPrompt</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>XPConfig</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>X</span> <span class='hs-conid'>()</span> <a name="line-59"></a><span class='hs-definition'>manPrompt</span> <span class='hs-varid'>c</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>do</span> <a name="line-60"></a> <span class='hs-varid'>mans</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>io</span> <span class='hs-varid'>getMans</span> <a name="line-61"></a> <span class='hs-varid'>mkXPrompt</span> <span class='hs-conid'>Man</span> <span class='hs-varid'>c</span> <span class='hs-layout'>(</span><span class='hs-varid'>manCompl</span> <span class='hs-varid'>mans</span><span class='hs-layout'>)</span> <span class='hs-varop'>$</span> <span class='hs-varid'>runInTerm</span> <span class='hs-str'>""</span> <span class='hs-varop'>.</span> <span class='hs-layout'>(</span><span class='hs-varop'>++</span><span class='hs-layout'>)</span> <span class='hs-str'>"man "</span> <a name="line-62"></a> <a name="line-63"></a><a name="getMans"></a><span class='hs-definition'>getMans</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>IO</span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>String</span><span class='hs-keyglyph'>]</span> <a name="line-64"></a><span class='hs-definition'>getMans</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>do</span> <a name="line-65"></a> <span class='hs-varid'>paths</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>getCommandOutput</span> <span class='hs-str'>"manpath -g 2>/dev/null"</span> <span class='hs-varop'>`</span><span class='hs-conid'>E</span><span class='hs-varop'>.</span><span class='hs-varid'>catch</span><span class='hs-varop'>`</span> <a name="line-66"></a> <span class='hs-keyglyph'>\</span><span class='hs-layout'>(</span><span class='hs-conid'>E</span><span class='hs-varop'>.</span><span class='hs-conid'>SomeException</span> <span class='hs-keyword'>_</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>return</span> <span class='hs-conid'>[]</span> <a name="line-67"></a> <span class='hs-keyword'>let</span> <span class='hs-varid'>sects</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyglyph'>[</span><span class='hs-str'>"man"</span> <span class='hs-varop'>++</span> <span class='hs-varid'>show</span> <span class='hs-varid'>n</span> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>n</span> <span class='hs-keyglyph'><-</span> <span class='hs-keyglyph'>[</span><span class='hs-num'>1</span><span class='hs-keyglyph'>..</span><span class='hs-num'>9</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Int</span><span class='hs-keyglyph'>]</span><span class='hs-keyglyph'>]</span> <a name="line-68"></a> <span class='hs-varid'>dirs</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyglyph'>[</span><span class='hs-varid'>d</span> <span class='hs-varop'>++</span> <span class='hs-str'>"/"</span> <span class='hs-varop'>++</span> <span class='hs-varid'>s</span> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>d</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>split</span> <span class='hs-chr'>':'</span> <span class='hs-varid'>paths</span><span class='hs-layout'>,</span> <span class='hs-varid'>s</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>sects</span><span class='hs-keyglyph'>]</span> <a name="line-69"></a> <span class='hs-varid'>mans</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>forM</span> <span class='hs-varid'>dirs</span> <span class='hs-varop'>$</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>d</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyword'>do</span> <a name="line-70"></a> <span class='hs-varid'>exists</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>doesDirectoryExist</span> <span class='hs-varid'>d</span> <a name="line-71"></a> <span class='hs-keyword'>if</span> <span class='hs-varid'>exists</span> <a name="line-72"></a> <span class='hs-keyword'>then</span> <span class='hs-varid'>map</span> <span class='hs-layout'>(</span><span class='hs-varid'>stripExt</span> <span class='hs-varop'>.</span> <span class='hs-varid'>stripSuffixes</span> <span class='hs-keyglyph'>[</span><span class='hs-str'>".gz"</span><span class='hs-layout'>,</span> <span class='hs-str'>".bz2"</span><span class='hs-keyglyph'>]</span><span class='hs-layout'>)</span> <span class='hs-varop'>`fmap`</span> <a name="line-73"></a> <span class='hs-varid'>getDirectoryContents</span> <span class='hs-varid'>d</span> <a name="line-74"></a> <span class='hs-keyword'>else</span> <span class='hs-varid'>return</span> <span class='hs-conid'>[]</span> <a name="line-75"></a> <span class='hs-varid'>return</span> <span class='hs-varop'>$</span> <span class='hs-varid'>uniqSort</span> <span class='hs-varop'>$</span> <span class='hs-varid'>concat</span> <span class='hs-varid'>mans</span> <a name="line-76"></a> <a name="line-77"></a><a name="manCompl"></a><span class='hs-definition'>manCompl</span> <span class='hs-keyglyph'>::</span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>String</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>String</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>IO</span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>String</span><span class='hs-keyglyph'>]</span> <a name="line-78"></a><span class='hs-definition'>manCompl</span> <span class='hs-varid'>mans</span> <span class='hs-varid'>s</span> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>s</span> <span class='hs-varop'>==</span> <span class='hs-str'>""</span> <span class='hs-varop'>||</span> <span class='hs-varid'>last</span> <span class='hs-varid'>s</span> <span class='hs-varop'>==</span> <span class='hs-chr'>' '</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>return</span> <span class='hs-conid'>[]</span> <a name="line-79"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>do</span> <a name="line-80"></a> <span class='hs-comment'>-- XXX readline instead of bash's compgen?</span> <a name="line-81"></a> <span class='hs-varid'>f</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>lines</span> <span class='hs-varop'>`fmap`</span> <span class='hs-varid'>getCommandOutput</span> <span class='hs-layout'>(</span><span class='hs-str'>"bash -c 'compgen -A file "</span> <span class='hs-varop'>++</span> <span class='hs-varid'>s</span> <span class='hs-varop'>++</span> <span class='hs-str'>"'"</span><span class='hs-layout'>)</span> <a name="line-82"></a> <span class='hs-varid'>mkComplFunFromList</span> <span class='hs-layout'>(</span><span class='hs-varid'>f</span> <span class='hs-varop'>++</span> <span class='hs-varid'>mans</span><span class='hs-layout'>)</span> <span class='hs-varid'>s</span> <a name="line-83"></a> <a name="line-84"></a><a name="getCommandOutput"></a><span class='hs-comment'>-- | Run a command using shell and return its output.</span> <a name="line-85"></a><span class='hs-comment'>--</span> <a name="line-86"></a><span class='hs-comment'>-- XXX Merge into 'XMonad.Util.Run'?</span> <a name="line-87"></a><span class='hs-comment'>--</span> <a name="line-88"></a><span class='hs-comment'>-- (Ask \"gurus\" whether @evaluate (length ...)@ approach is</span> <a name="line-89"></a><span class='hs-comment'>-- better\/more idiomatic.)</span> <a name="line-90"></a><span class='hs-definition'>getCommandOutput</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>String</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>IO</span> <span class='hs-conid'>String</span> <a name="line-91"></a><span class='hs-definition'>getCommandOutput</span> <span class='hs-varid'>s</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>do</span> <a name="line-92"></a> <span class='hs-comment'>-- we can ignore the process handle because we ignor SIGCHLD</span> <a name="line-93"></a> <span class='hs-layout'>(</span><span class='hs-varid'>pin</span><span class='hs-layout'>,</span> <span class='hs-varid'>pout</span><span class='hs-layout'>,</span> <span class='hs-varid'>perr</span><span class='hs-layout'>,</span> <span class='hs-keyword'>_</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>runInteractiveCommand</span> <span class='hs-varid'>s</span> <a name="line-94"></a> <span class='hs-varid'>hClose</span> <span class='hs-varid'>pin</span> <a name="line-95"></a> <span class='hs-varid'>output</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>hGetContents</span> <span class='hs-varid'>pout</span> <a name="line-96"></a> <span class='hs-conid'>E</span><span class='hs-varop'>.</span><span class='hs-varid'>evaluate</span> <span class='hs-layout'>(</span><span class='hs-varid'>length</span> <span class='hs-varid'>output</span><span class='hs-layout'>)</span> <a name="line-97"></a> <span class='hs-varid'>hClose</span> <span class='hs-varid'>perr</span> <a name="line-98"></a> <span class='hs-varid'>return</span> <span class='hs-varid'>output</span> <a name="line-99"></a> <a name="line-100"></a><a name="stripExt"></a><span class='hs-definition'>stripExt</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>String</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>String</span> <a name="line-101"></a><span class='hs-definition'>stripExt</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>reverse</span> <span class='hs-varop'>.</span> <span class='hs-varid'>drop</span> <span class='hs-num'>1</span> <span class='hs-varop'>.</span> <span class='hs-varid'>dropWhile</span> <span class='hs-layout'>(</span><span class='hs-varop'>/=</span> <span class='hs-chr'>'.'</span><span class='hs-layout'>)</span> <span class='hs-varop'>.</span> <span class='hs-varid'>reverse</span> <a name="line-102"></a> <a name="line-103"></a><a name="stripSuffixes"></a><span class='hs-definition'>stripSuffixes</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Eq</span> <span class='hs-varid'>a</span> <span class='hs-keyglyph'>=></span> <span class='hs-keyglyph'>[</span><span class='hs-keyglyph'>[</span><span class='hs-varid'>a</span><span class='hs-keyglyph'>]</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-varid'>a</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-varid'>a</span><span class='hs-keyglyph'>]</span> <a name="line-104"></a><span class='hs-definition'>stripSuffixes</span> <span class='hs-varid'>sufs</span> <span class='hs-varid'>fn</span> <span class='hs-keyglyph'>=</span> <a name="line-105"></a> <span class='hs-varid'>head</span> <span class='hs-varop'>.</span> <span class='hs-varid'>catMaybes</span> <span class='hs-varop'>$</span> <span class='hs-varid'>map</span> <span class='hs-layout'>(</span><span class='hs-varid'>flip</span> <span class='hs-varid'>rstrip</span> <span class='hs-varid'>fn</span><span class='hs-layout'>)</span> <span class='hs-varid'>sufs</span> <span class='hs-varop'>++</span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>Just</span> <span class='hs-varid'>fn</span><span class='hs-keyglyph'>]</span> <a name="line-106"></a> <a name="line-107"></a><a name="rstrip"></a><span class='hs-definition'>rstrip</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Eq</span> <span class='hs-varid'>a</span> <span class='hs-keyglyph'>=></span> <span class='hs-keyglyph'>[</span><span class='hs-varid'>a</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-varid'>a</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Maybe</span> <span class='hs-keyglyph'>[</span><span class='hs-varid'>a</span><span class='hs-keyglyph'>]</span> <a name="line-108"></a><span class='hs-definition'>rstrip</span> <span class='hs-varid'>suf</span> <span class='hs-varid'>lst</span> <a name="line-109"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>suf</span> <span class='hs-varop'>`isSuffixOf`</span> <span class='hs-varid'>lst</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Just</span> <span class='hs-varop'>$</span> <span class='hs-varid'>take</span> <span class='hs-layout'>(</span><span class='hs-varid'>length</span> <span class='hs-varid'>lst</span> <span class='hs-comment'>-</span> <span class='hs-varid'>length</span> <span class='hs-varid'>suf</span><span class='hs-layout'>)</span> <span class='hs-varid'>lst</span> <a name="line-110"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Nothing</span> </pre></body> </html>
