diff options
| -rw-r--r-- | readme.md | 224 | 
1 files changed, 112 insertions, 112 deletions
| @@ -21,62 +21,62 @@          - [Example for using the DBus IPC interface with XMonad](#example-for-using-the-dbus-ipc-interface-with-xmonad)      - [The Output Template](#the-output-template)      - [The `commands` Configuration Option](#the-commands-configuration-option) -    - [System Monitor Plugins](#system-monitor-plugins) -        - [Icon patterns](#icon-patterns) -        - [Default Monitor Arguments](#default-monitor-arguments) -        - [`Uptime Args RefreshRate`](#uptime-args-refreshrate) -        - [`Weather StationID Args RefreshRate`](#weather-stationid-args-refreshrate) -        - [`WeatherX StationID SkyConditions Args RefreshRate`](#weatherx-stationid-skyconditions-args-refreshrate) -        - [`Network Interface Args RefreshRate`](#network-interface-args-refreshrate) -        - [`DynNetwork Args RefreshRate`](#dynnetwork-args-refreshrate) -        - [`Wireless Interface Args RefreshRate`](#wireless-interface-args-refreshrate) -        - [`Memory Args RefreshRate`](#memory-args-refreshrate) -        - [`Swap Args RefreshRate`](#swap-args-refreshrate) -        - [`Cpu Args RefreshRate`](#cpu-args-refreshrate) -        - [`MultiCpu Args RefreshRate`](#multicpu-args-refreshrate) -        - [`Battery Args RefreshRate`](#battery-args-refreshrate) -        - [`BatteryP Dirs Args RefreshRate`](#batteryp-dirs-args-refreshrate) -        - [`BatteryN Dirs Args RefreshRate Alias`](#batteryn-dirs-args-refreshrate-alias) -        - [`TopProc Args RefreshRate`](#topproc-args-refreshrate) -        - [`TopMem Args RefreshRate`](#topmem-args-refreshrate) -        - [`DiskU Disks Args RefreshRate`](#disku-disks-args-refreshrate) -        - [`DiskIO Disks Args RefreshRate`](#diskio-disks-args-refreshrate) -        - [`ThermalZone Number Args RefreshRate`](#thermalzone-number-args-refreshrate) -            - [`Thermal Zone Args RefreshRate`](#thermal-zone-args-refreshrate) -        - [`CpuFreq Args RefreshRate`](#cpufreq-args-refreshrate) -        - [`CoreTemp Args RefreshRate`](#coretemp-args-refreshrate) -        - [`MultiCoreTemp Args RefreshRate`](#multicoretemp-args-refreshrate) -        - [`Volume Mixer Element Args RefreshRate`](#volume-mixer-element-args-refreshrate) -        - [`Alsa Mixer Element Args`](#alsa-mixer-element-args) -        - [`MPD Args RefreshRate`](#mpd-args-refreshrate) -        - [`Mpris1 PlayerName Args RefreshRate`](#mpris1-playername-args-refreshrate) -        - [`Mpris2 PlayerName Args RefreshRate`](#mpris2-playername-args-refreshrate) -        - [`Mail Args Alias`](#mail-args-alias) -        - [`MailX Args Opts Alias`](#mailx-args-opts-alias) -        - [`MBox Mboxes Opts Alias`](#mbox-mboxes-opts-alias) -        - [`XPropertyLog PropName`](#xpropertylog-propname) -        - [`UnsafeXPropertyLog PropName`](#unsafexpropertylog-propname) -        - [`NamedXPropertyLog PropName Alias`](#namedxpropertylog-propname-alias) -        - [`NamedXPropertyLog PropName Alias`](#namedxpropertylog-propname-alias-1) -        - [`Brightness Args RefreshRate`](#brightness-args-refreshrate) -        - [`Kbd Opts`](#kbd-opts) -        - [`Locks`](#locks) -        - [`CatInt n filename`](#catint-n-filename) -        - [`UVMeter`](#uvmeter) -    - [Executing External Commands](#executing-external-commands) -    - [Other Plugins](#other-plugins) -        - [`StdinReader`](#stdinreader) -        - [`UnsafeStdinReader`](#unsafestdinreader) -        - [`Date Format Alias RefreshRate`](#date-format-alias-refreshrate) -        - [`DateZone Format Locale Zone Alias RefreshRate`](#datezone-format-locale-zone-alias-refreshrate) -        - [`CommandReader "/path/to/program" Alias`](#commandreader-pathtoprogram-alias) -        - [`PipeReader "default text:/path/to/pipe" Alias`](#pipereader-default-textpathtopipe-alias) -        - [`MarqueePipeReader "default text:/path/to/pipe" (length, rate, sep) Alias`](#marqueepipereader-default-textpathtopipe-length-rate-sep-alias) -        - [`BufferedPipeReader Alias [(Timeout, Bool, "/path/to/pipe1"), ..]`](#bufferedpipereader-alias-timeout-bool-pathtopipe1-) -        - [`XMonadLog`](#xmonadlog) -        - [`UnsafeXMonadLog`](#unsafexmonadlog) -        - [`HandleReader Handle Alias`](#handlereader-handle-alias) -- [Plugins](#plugins) +- [System Monitor Plugins](#system-monitor-plugins) +    - [Icon patterns](#icon-patterns) +    - [Default Monitor Arguments](#default-monitor-arguments) +    - [`Uptime Args RefreshRate`](#uptime-args-refreshrate) +    - [`Weather StationID Args RefreshRate`](#weather-stationid-args-refreshrate) +    - [`WeatherX StationID SkyConditions Args RefreshRate`](#weatherx-stationid-skyconditions-args-refreshrate) +    - [`Network Interface Args RefreshRate`](#network-interface-args-refreshrate) +    - [`DynNetwork Args RefreshRate`](#dynnetwork-args-refreshrate) +    - [`Wireless Interface Args RefreshRate`](#wireless-interface-args-refreshrate) +    - [`Memory Args RefreshRate`](#memory-args-refreshrate) +    - [`Swap Args RefreshRate`](#swap-args-refreshrate) +    - [`Cpu Args RefreshRate`](#cpu-args-refreshrate) +    - [`MultiCpu Args RefreshRate`](#multicpu-args-refreshrate) +    - [`Battery Args RefreshRate`](#battery-args-refreshrate) +    - [`BatteryP Dirs Args RefreshRate`](#batteryp-dirs-args-refreshrate) +    - [`BatteryN Dirs Args RefreshRate Alias`](#batteryn-dirs-args-refreshrate-alias) +    - [`TopProc Args RefreshRate`](#topproc-args-refreshrate) +    - [`TopMem Args RefreshRate`](#topmem-args-refreshrate) +    - [`DiskU Disks Args RefreshRate`](#disku-disks-args-refreshrate) +    - [`DiskIO Disks Args RefreshRate`](#diskio-disks-args-refreshrate) +    - [`ThermalZone Number Args RefreshRate`](#thermalzone-number-args-refreshrate) +    - [`Thermal Zone Args RefreshRate`](#thermal-zone-args-refreshrate) +    - [`CpuFreq Args RefreshRate`](#cpufreq-args-refreshrate) +    - [`CoreTemp Args RefreshRate`](#coretemp-args-refreshrate) +    - [`MultiCoreTemp Args RefreshRate`](#multicoretemp-args-refreshrate) +    - [`Volume Mixer Element Args RefreshRate`](#volume-mixer-element-args-refreshrate) +    - [`Alsa Mixer Element Args`](#alsa-mixer-element-args) +    - [`MPD Args RefreshRate`](#mpd-args-refreshrate) +    - [`Mpris1 PlayerName Args RefreshRate`](#mpris1-playername-args-refreshrate) +    - [`Mpris2 PlayerName Args RefreshRate`](#mpris2-playername-args-refreshrate) +    - [`Mail Args Alias`](#mail-args-alias) +    - [`MailX Args Opts Alias`](#mailx-args-opts-alias) +    - [`MBox Mboxes Opts Alias`](#mbox-mboxes-opts-alias) +    - [`XPropertyLog PropName`](#xpropertylog-propname) +    - [`UnsafeXPropertyLog PropName`](#unsafexpropertylog-propname) +    - [`NamedXPropertyLog PropName Alias`](#namedxpropertylog-propname-alias) +    - [`NamedXPropertyLog PropName Alias`](#namedxpropertylog-propname-alias-1) +    - [`Brightness Args RefreshRate`](#brightness-args-refreshrate) +    - [`Kbd Opts`](#kbd-opts) +    - [`Locks`](#locks) +    - [`CatInt n filename`](#catint-n-filename) +    - [`UVMeter`](#uvmeter) +- [Executing External Commands](#executing-external-commands) +- [Other Plugins](#other-plugins) +    - [`StdinReader`](#stdinreader) +    - [`UnsafeStdinReader`](#unsafestdinreader) +    - [`Date Format Alias RefreshRate`](#date-format-alias-refreshrate) +    - [`DateZone Format Locale Zone Alias RefreshRate`](#datezone-format-locale-zone-alias-refreshrate) +    - [`CommandReader "/path/to/program" Alias`](#commandreader-pathtoprogram-alias) +    - [`PipeReader "default text:/path/to/pipe" Alias`](#pipereader-default-textpathtopipe-alias) +    - [`MarqueePipeReader "default text:/path/to/pipe" (length, rate, sep) Alias`](#marqueepipereader-default-textpathtopipe-length-rate-sep-alias) +    - [`BufferedPipeReader Alias [(Timeout, Bool, "/path/to/pipe1"), ..]`](#bufferedpipereader-alias-timeout-bool-pathtopipe1-) +    - [`XMonadLog`](#xmonadlog) +    - [`UnsafeXMonadLog`](#unsafexmonadlog) +    - [`HandleReader Handle Alias`](#handlereader-handle-alias) +- [User plugins](#user-plugins)      - [Writing a Plugin](#writing-a-plugin)      - [Using a Plugin](#using-a-plugin)      - [Configurations written in pure Haskell](#configurations-written-in-pure-haskell) @@ -644,7 +644,7 @@ plugin, and much more: we list all available plugins below.  Other commands can be created as plugins with the Plugin  infrastructure. See below. -## System Monitor Plugins +# System Monitor Plugins  This is the description of the system monitor plugins available in  xmobar.  Some of them are only installed when an optional build option @@ -655,7 +655,7 @@ Monitors have default aliases.  The sections below describe every  monitor in turn, but before we provide a list of the configuration  options (or *monitor arguments*) they all share. -### Icon patterns +## Icon patterns  Some monitors allow usage of strings that depend on some integer value  from 0 to 8 by replacing all occurrences of `"%%"` with it @@ -673,7 +673,7 @@ it allows to replace vertical bars with custom icons. For example,  Will display `bright_0.xpm` to `bright_8.xpm` depending on current brightness  value. -### Default Monitor Arguments +## Default Monitor Arguments  Monitors accept a common set of arguments, described in the first  subsection below.  In addition, some monitors accept additional options @@ -809,7 +809,7 @@ something like:      Glasgow Airport: 16.0C -### `Uptime Args RefreshRate` +## `Uptime Args RefreshRate`  - Aliases to `uptime`  - Args: default monitor arguments. The low and high @@ -820,7 +820,7 @@ something like:    to add units to the display of those numeric fields.  - Default template: `Up: <days>d <hours>h <minutes>m` -### `Weather StationID Args RefreshRate` +## `Weather StationID Args RefreshRate`  - Aliases to the Station ID: so `Weather "LIPB" []` can be used in    template as `%LIPB%` @@ -843,7 +843,7 @@ something like:  - Default template: `<station>: <tempC>C, rh <rh>% (<hour>)`  - Retrieves weather information from http://tgftp.nws.noaa.gov. -### `WeatherX StationID SkyConditions Args RefreshRate` +## `WeatherX StationID SkyConditions Args RefreshRate`  - Works in the same way as `Weather`, but takes an additional    argument, a list of pairs from sky conditions to their replacement @@ -876,7 +876,7 @@ For example:  As mentioned, the replacement string can also be an icon  specification, such as `("clear", "<icon=weather-clear.xbm/>")`. -### `Network Interface Args RefreshRate` +## `Network Interface Args RefreshRate`  - Aliases to the interface name: so `Network "eth0" []` can be used as    `%eth0%` @@ -894,7 +894,7 @@ specification, such as `("clear", "<icon=weather-clear.xbm/>")`.    Mb/s, etc.).  - Default template: `<dev>: <rx>KB|<tx>KB` -### `DynNetwork Args RefreshRate` +## `DynNetwork Args RefreshRate`  - Active interface is detected automatically  - Aliases to "dynnetwork" @@ -911,7 +911,7 @@ specification, such as `("clear", "<icon=weather-clear.xbm/>")`.  - Default template: `<dev>: <rx>KB|<tx>KB`  - Example of usage of `--devices` option: `["--", "--devices", "wlp2s0,enp0s20f41"]` -### `Wireless Interface Args RefreshRate` +## `Wireless Interface Args RefreshRate`  - If set to "", first suitable wireless interface is used.  - Aliases to the interface name with the suffix "wi": thus, `Wireless @@ -929,7 +929,7 @@ specification, such as `("clear", "<icon=weather-clear.xbm/>")`.  - To activate this plugin you must pass `--flags="with_nl80211"` or    `--flags="with_iwlib"` during compilation -### `Memory Args RefreshRate` +## `Memory Args RefreshRate`  - Aliases to `memory`  - Args: default monitor arguments, plus: @@ -944,7 +944,7 @@ specification, such as `("clear", "<icon=weather-clear.xbm/>")`.               `availableratio`, `availablebar`, `availablevbar`, `availableipat`  - Default template: `Mem: <usedratio>% (<cache>M)` -### `Swap Args RefreshRate` +## `Swap Args RefreshRate`  - Aliases to `swap`  - Args: default monitor arguments @@ -953,7 +953,7 @@ specification, such as `("clear", "<icon=weather-clear.xbm/>")`.  	    `total`, `used`, `free`, `usedratio`  - Default template: `Swap: <usedratio>%` -### `Cpu Args RefreshRate` +## `Cpu Args RefreshRate`  - Aliases to `cpu`  - Args: default monitor arguments, plus: @@ -963,7 +963,7 @@ specification, such as `("clear", "<icon=weather-clear.xbm/>")`.  	    `total`, `bar`, `vbar`, `ipat`, `user`, `nice`, `system`, `idle`, `iowait`  - Default template: `Cpu: <total>%` -### `MultiCpu Args RefreshRate` +## `MultiCpu Args RefreshRate`  - Aliases to `multicpu`  - Args: default monitor arguments, plus: @@ -985,11 +985,11 @@ specification, such as `("clear", "<icon=weather-clear.xbm/>")`.    and display one entry for each.  - Default template: `Cpu: <total>%` -### `Battery Args RefreshRate` +## `Battery Args RefreshRate`  - Same as `BatteryP ["BAT", "BAT0", "BAT1", "BAT2"] Args RefreshRate`. -### `BatteryP Dirs Args RefreshRate` +## `BatteryP Dirs Args RefreshRate`  - Aliases to `battery` @@ -1070,13 +1070,13 @@ specification, such as `("clear", "<icon=weather-clear.xbm/>")`.  - The "idle" AC state is selected whenever the AC power entering the    battery is zero. -### `BatteryN Dirs Args RefreshRate Alias` +## `BatteryN Dirs Args RefreshRate Alias`  Works like `BatteryP`, but lets you specify an alias for the monitor  other than "battery".  Useful in case you one separate monitors for  more than one battery. -### `TopProc Args RefreshRate` +## `TopProc Args RefreshRate`  - Aliases to `top`  - Args: default monitor arguments. The low and high @@ -1093,7 +1093,7 @@ more than one battery.    maximum and/or minimum width, using the `-m`/`-M` arguments. `no` gives    the total number of processes. -### `TopMem Args RefreshRate` +## `TopMem Args RefreshRate`  - Aliases to `topmem`  - Args: default monitor arguments. The low and high @@ -1106,7 +1106,7 @@ more than one battery.    processes (`bothn` displays both, and is useful to specify an    overall maximum and/or minimum width, using the `-m`/`-M` arguments. -### `DiskU Disks Args RefreshRate` +## `DiskU Disks Args RefreshRate`  - Aliases to `disku`  - Disks: list of pairs of the form (device or mount point, template), @@ -1125,7 +1125,7 @@ more than one battery.                 ["-L", "20", "-H", "50", "-m", "1", "-p", "3"]                 20 -### `DiskIO Disks Args RefreshRate` +## `DiskIO Disks Args RefreshRate`  - Aliases to `diskio`  - Disks: list of pairs of the form (device or mount point, template), @@ -1148,7 +1148,7 @@ more than one battery.           DiskIO [("/", "<read> <write>"), ("sdb1", "<total>")] [] 10 -### `ThermalZone Number Args RefreshRate` +## `ThermalZone Number Args RefreshRate`  - Aliases to "thermaln": so `ThermalZone 0 []` can be used in template    as `%thermal0%` @@ -1165,7 +1165,7 @@ more than one battery.           Run ThermalZone 0 ["-t","<id>: <temp>C"] 30 -#### `Thermal Zone Args RefreshRate` +## `Thermal Zone Args RefreshRate`  - **This plugin is deprecated. Use `ThermalZone` instead.** @@ -1182,7 +1182,7 @@ more than one battery.           Run Thermal "THRM" ["-t","iwl4965-temp: <temp>C"] 50 -### `CpuFreq Args RefreshRate` +## `CpuFreq Args RefreshRate`  - Aliases to `cpufreq`  - Args: default monitor arguments @@ -1196,7 +1196,7 @@ more than one battery.           Run CpuFreq ["-t", "Freq:<cpu0>|<cpu1>GHz", "-L", "0", "-H", "2",                        "-l", "lightblue", "-n","white", "-h", "red"] 50 -### `CoreTemp Args RefreshRate` +## `CoreTemp Args RefreshRate`  - Aliases to `coretemp`  - Args: default monitor arguments @@ -1211,7 +1211,7 @@ more than one battery.                         "-L", "40", "-H", "60",                         "-l", "lightblue", "-n", "gray90", "-h", "red"] 50 -### `MultiCoreTemp Args RefreshRate` +## `MultiCoreTemp Args RefreshRate`  - Aliases to `multicoretemp`  - Args: default monitor arguments, plus: @@ -1248,7 +1248,7 @@ more than one battery.                              "-l", "green", "-n", "yellow", "-h", "red",                              "--", "--mintemp", "20", "--maxtemp", "100"] 50 -### `Volume Mixer Element Args RefreshRate` +## `Volume Mixer Element Args RefreshRate`  - Aliases to the mixer name and element name separated by a colon. Thus,    `Volume "default" "Master" [] 10` can be used as `%default:Master%`. @@ -1301,7 +1301,7 @@ more than one battery.    system. In addition, to activate this plugin you must pass    `--flags="with_alsa"` during compilation. -### `Alsa Mixer Element Args` +## `Alsa Mixer Element Args`  Like [Volume](#volume-mixer-element-args-refreshrate), but with the  following differences: @@ -1320,7 +1320,7 @@ following differences:  - `stdbuf` (from coreutils) must be (and most probably already is) in    your `PATH`. -### `MPD Args RefreshRate` +## `MPD Args RefreshRate`  - This monitor will only be compiled if you ask for it using the    `with_mpd` flag. It needs [libmpd] 5.0 or later (available on Hackage). @@ -1348,7 +1348,7 @@ following differences:                    "<composer> <title> (<album>) <track>/<plength> <statei> [<flags>]",                    "--", "-P", ">>", "-Z", "|", "-S", "><"] 10 -### `Mpris1 PlayerName Args RefreshRate` +## `Mpris1 PlayerName Args RefreshRate`  - Aliases to `mpris1`  - Requires [dbus] and [text] packages. @@ -1364,7 +1364,7 @@ following differences:           Run Mpris1 "clementine" ["-t", "<artist> - [<tracknumber>] <title>"] 10 -### `Mpris2 PlayerName Args RefreshRate` +## `Mpris2 PlayerName Args RefreshRate`  - Aliases to `mpris2`  - Requires [dbus] and [text] packages. @@ -1381,7 +1381,7 @@ following differences:           Run Mpris2 "spotify" ["-t", "<artist> - [<composer>] <title>"] 10 -### `Mail Args Alias` +## `Mail Args Alias`  - Args: list of maildirs in form    `[("name1","path1"),...]`. Paths may start with a '~' @@ -1395,7 +1395,7 @@ following differences:                     ("lists", "~/var/mail/lists")]                    "mail" -### `MailX Args Opts Alias` +## `MailX Args Opts Alias`  - Args: list of maildirs in form    `[("name1","path1","color1"),...]`. Paths may start with a '~' @@ -1419,7 +1419,7 @@ following differences:                     "mail" -### `MBox Mboxes Opts Alias` +## `MBox Mboxes Opts Alias`  - Mboxes a list of mbox files of the form `[("name", "path", "color")]`,    where name is the displayed name, path the absolute or relative (to @@ -1446,7 +1446,7 @@ following differences:           Run MBox [("I ", "inbox", "red"), ("O ", "~/foo/mbox", "")]                    ["-d", "/var/mail/", "-p", " "] "mbox" -### `XPropertyLog PropName` +## `XPropertyLog PropName`  - Aliases to `PropName`  - Reads the X property named by `PropName` (a string) and displays its @@ -1456,7 +1456,7 @@ following differences:  [examples/xmonadpropwrite.hs script]: https://github.com/jaor/xmobar/raw/master/examples/xmonadpropwrite.hs -### `UnsafeXPropertyLog PropName` +## `UnsafeXPropertyLog PropName`  - Aliases to `PropName`  - Same as `XPropertyLog`, but the input is not filtered to avoid @@ -1464,17 +1464,17 @@ following differences:    the value of the read property is responsible of performing any    needed cleanups. -### `NamedXPropertyLog PropName Alias` +## `NamedXPropertyLog PropName Alias`  - Aliases to `Alias`  - Same as `XPropertyLog`, but a custom alias can be specified. -### `NamedXPropertyLog PropName Alias` +## `NamedXPropertyLog PropName Alias`  - Aliases to `Alias`  - Same as `UnsafeXPropertyLog`, but a custom alias can be specified. -### `Brightness Args RefreshRate` +## `Brightness Args RefreshRate`  - Aliases to `bright`  - Args: default monitor arguments, plus the following specif ones: @@ -1492,7 +1492,7 @@ following differences:         Run Brightness ["-t", "<bar>"] 60 -### `Kbd Opts` +## `Kbd Opts`  - Registers to XKB/X11-Events and output the currently active keyboard layout.    Supports replacement of layout names. @@ -1504,7 +1504,7 @@ following differences:  		Run Kbd [("us(dvorak)", "DV"), ("us", "US")] -### `Locks` +## `Locks`  - Displays the status of Caps Lock, Num Lock and Scroll Lock.  - Aliases to `locks` @@ -1512,7 +1512,7 @@ following differences:  	Run Locks -### `CatInt n filename` +## `CatInt n filename`  - Reads and displays an integer from the file whose path is `filename`    (especially useful with files in `/sys`). @@ -1522,7 +1522,7 @@ following differences:      Run CatInt 0 "/sys/devices/platform/thinkpad_hwmon/fan1_input" [] 50 -### `UVMeter` +## `UVMeter`  - Aliases to "uv " + station id. For example: `%uv Brisbane%` or `%uv    Alice Springs%` @@ -1541,7 +1541,7 @@ following differences:          Run UVMeter "Brisbane" ["-H", "3", "-L", "3", "--low", "green", "--high", "red"] 900 -## Executing External Commands +# Executing External Commands  In order to execute an external command you can either write the  command name in the template, in this case it will be executed without @@ -1582,9 +1582,9 @@ execution fails.  For instance:  will display "N/A" if for some reason the `date` invocation fails. -## Other Plugins +# Other Plugins -### `StdinReader` +## `StdinReader`  - Aliases to StdinReader  - Displays any text received by xmobar on its standard input. @@ -1592,7 +1592,7 @@ will display "N/A" if for some reason the `date` invocation fails.    actions via stdin.  This is safer than `UnsafeStdinReader` because there is    no need to escape the content before passing it to xmobar's standard input. -### `UnsafeStdinReader` +## `UnsafeStdinReader`  - Aliases to UnsafeStdinReader  - Displays any text received by xmobar on its standard input. @@ -1606,13 +1606,13 @@ will display "N/A" if for some reason the `date` invocation fails.    clicking on xmobar:    ```<action=`xdotool key alt+1`>ws1</action> <action=`xdotool key alt+1`>ws2</action>``` -### `Date Format Alias RefreshRate` +## `Date Format Alias RefreshRate`  - Format is a time format string, as accepted by the standard ISO C    `strftime` function (or Haskell's `formatCalendarTime`).  - Sample usage: `Run Date "%a %b %_d %Y <fc=#ee9a00>%H:%M:%S</fc>" "date" 10` -### `DateZone Format Locale Zone Alias RefreshRate` +## `DateZone Format Locale Zone Alias RefreshRate`  - Format is a time format string, as accepted by the standard ISO C    `strftime` function (or Haskell's `formatCalendarTime`). @@ -1625,17 +1625,17 @@ will display "N/A" if for some reason the `date` invocation fails.  - Sample usage:    `Run DateZone "%a %H:%M:%S" "de_DE.UTF-8" "Europe/Vienna" "viennaTime" 10` -### `CommandReader "/path/to/program" Alias` +## `CommandReader "/path/to/program" Alias`  - Runs the given program, and displays its standard output. -### `PipeReader "default text:/path/to/pipe" Alias` +## `PipeReader "default text:/path/to/pipe" Alias`  - Reads its displayed output from the given pipe.  - Prefix an optional default text separated by a colon  - Expands environment variables in the first argument of syntax '${VAR}' or '$VAR' -### `MarqueePipeReader "default text:/path/to/pipe" (length, rate, sep) Alias` +## `MarqueePipeReader "default text:/path/to/pipe" (length, rate, sep) Alias`  - Generally equivalent to PipeReader  - Text is displayed as marquee with the specified length, rate in 10th @@ -1645,7 +1645,7 @@ will display "N/A" if for some reason the `date` invocation fails.  - Expands environment variables in the first argument -### `BufferedPipeReader Alias [(Timeout, Bool, "/path/to/pipe1"), ..]` +## `BufferedPipeReader Alias [(Timeout, Bool, "/path/to/pipe1"), ..]`  - Display data from multiple pipes.  - Timeout (in tenth of seconds) is the value after which the previous @@ -1677,7 +1677,7 @@ will display "N/A" if for some reason the `date` invocation fails.  [examples/status.sh]: http://github.com/jaor/xmobar/raw/master/examples/status.sh -### `XMonadLog` +## `XMonadLog`  - Aliases to XMonadLog  - Displays information from xmonad's `_XMONAD_LOG`. You can set this @@ -1695,7 +1695,7 @@ will display "N/A" if for some reason the `date` invocation fails.  [here]: http://xmonad.org/xmonad-docs/xmonad-contrib/XMonad-Hooks-DynamicLog.html -### `UnsafeXMonadLog` +## `UnsafeXMonadLog`  - Aliases to UnsafeXMonadLog  - Similar to StdinReader versus UnsafeStdinReader, this does not strip `<action @@ -1708,7 +1708,7 @@ will display "N/A" if for some reason the `date` invocation fails.            logHook = dynamicLogString myPP >>= xmonadPropLog          } -### `HandleReader Handle Alias` +## `HandleReader Handle Alias`  - Display data from a Haskell `Handle`  - This plugin is only useful if you are running xmobar from another Haskell @@ -1725,7 +1725,7 @@ will display "N/A" if for some reason the `date` invocation fails.          hPutStr writeHandle "Hello World" -# Plugins +# User plugins  ## Writing a Plugin | 
