 | xmonad-contrib-0.5: Third party extensions for xmonad | Source code | Contents | Index |
| XMonad.Util.Run |
|
| Contents |
| runProcessWithInput :: FilePath -> [String] -> String -> IO String |
| runProcessWithInputAndWait :: FilePath -> [String] -> String -> Int -> IO () |
| safeSpawn :: MonadIO m => FilePath -> String -> m () |
| unsafeSpawn :: MonadIO m => String -> m () |
| runInTerm :: String -> X () |
| safeRunInTerm :: String -> X () |
| seconds :: Rational -> Int |
| spawnPipe :: String -> IO Handle |
For an example usage of runInTerm see XMonad.Prompt.Ssh
For an example usage of runProcessWithInput see XMonad.Prompt.DirectoryPrompt, XMonad.Util.Dmenu, XMonad.Prompt.ShellPrompt, XMonad.Actions.WmiiActions, XMonad.Prompt.WorkspaceDir
For an example usage of runProcessWithInputAndWait see XMonad.Util.Dzen
| runProcessWithInput :: FilePath -> [String] -> String -> IO String | Source |
| runProcessWithInputAndWait :: FilePath -> [String] -> String -> Int -> IO () | Source |
| safeSpawn :: MonadIO m => FilePath -> String -> m () | Source |
safeSpawn bypasses XMonad's spawn command, because spawn passes strings to /bin/sh to be interpreted as shell commands. This is often what one wants, but in many cases the passed string will contain shell metacharacters which one does not want interpreted as such (URLs particularly often have shell metacharacters like '&' in them). In this case, it is more useful to specify a file or program to be run and a string to give it as an argument so as to bypass the shell and be certain the program will receive the string as you typed it. unsafeSpawn is an alias for XMonad's spawn, to remind one that use of it can be, well, unsafe. Examples:
, ((modMask, xK_Print), unsafeSpawn "import -window root png:$HOME/xwd-$(date +%s)$$.png")
, ((modMask, xK_d ), safeSpawn "firefox" "")
Note that the unsafeSpawn example must be unsafe and not safe because it makes use of shell interpretation by relying on $HOME and interpolation, whereas the safeSpawn example can be safe because Firefox doesn't need any arguments if it is just being started.
| unsafeSpawn :: MonadIO m => String -> m () | Source |
| runInTerm :: String -> X () | Source |
| safeRunInTerm :: String -> X () | Source |
| seconds :: Rational -> Int | Source |
Multiplies by ONE MILLION, for use with runProcessWithInputAndWait.
Use like:
(5.5 `seconds`)
| spawnPipe :: String -> IO Handle | Source |