readme cleanups

1 files changed, 114 insertions, 148 deletions

diff --git a/readme.md b/readme.md
index a2510cf..6b8c656 100644
--- a/readme.md
+++ b/readme.md
@@ -102,76 +102,63 @@ Extensions need additional libraries (listed below) that will be
 automatically downloaded and installed if you're using cabal install.
 Otherwise, you'll need to install them yourself.
 
-`with_dbus`
-:    Enables support for DBUS by making xmobar to publish a service on
-     the session bus.  Requires the [dbus] package.
+- `with_dbus` Enables support for DBUS by making xmobar to publish a
+  service on the session bus.  Requires the [dbus] package.
 
-`with_threaded`
-:    Uses GHC's threaded runtime.  Use this option if xmobar enters a
-     high-CPU regime right after starting.
+- `with_threaded` Uses GHC's threaded runtime.  Use this option if
+  xmobar enters a high-CPU regime right after starting.
 
-`with_utf8`
-:    UTF-8 support. Requires the [utf8-string] package.
+- `with_utf8` UTF-8 support. Requires the [utf8-string] package.
 
-`with_xft`
-:    Antialiased fonts. Requires the [X11-xft] package. This option
-     automatically enables UTF-8.
-
-     To use XFT fonts you need to use the `xft:` prefix in the `font`
-     configuration option. For instance:
+- `with_xft` Antialiased fonts. Requires the [X11-xft] package. This
+  option automatically enables UTF-8.  To use XFT fonts you need to
+  use the `xft:` prefix in the `font` configuration option. For
+  instance:
 
         font = "xft:Times New Roman-10:italic"
 
-     Or to have fallback fonts, just separate them by commas:
+  Or to have fallback fonts, just separate them by commas:
 
         font = "xft:Open Sans:size=9,WenQuanYi Zen Hei:size=9"
 
-`with_mpd`
-:    Enables support for the [MPD] daemon. Requires the [libmpd] package.
+- `with_mpd` Enables support for the [MPD] daemon. Requires the
+  [libmpd] package.
 
-`with_mpris`
-:    Enables support for MPRIS v1/v2 protocol.
-     Requires the [dbus] and [text] packages.
+- `with_mpris` Enables support for MPRIS v1/v2 protocol.  Requires the
+  [dbus] and [text] packages.
 
-`with_inotify`
-:    Support for inotify in modern Linux kernels. This option is needed
-     for the MBox and Mail plugins to work. Requires the [hinotify]
-     package.
+- `with_inotify` Support for inotify in modern Linux kernels. This
+  option is needed for the MBox and Mail plugins to work. Requires the
+  [hinotify] package.
 
-`with_iwlib`
-:    Support for wireless cards. Enables the Wireless plugin. No Haskell
-     library is required, but you will need the [iwlib] C library and
-     headers in your system (e.g., install `libiw-dev` in Debian-based
-     systems or `wireless_tools` on Arch Linux).
+- `with_iwlib` Support for wireless cards. Enables the Wireless
+   plugin. No Haskell library is required, but you will need the
+   [iwlib] C library and headers in your system (e.g., install
+   `libiw-dev` in Debian-based systems or `wireless_tools` on Arch
+   Linux).
 
-`with_alsa`
-:    Support for ALSA sound cards. Enables the Volume plugin. Requires the
-     [alsa-mixer] package.  To install the latter, you'll need the
-     [libasound] C library and headers in your system (e.g., install
-     `libasound2-dev` in Debian-based systems).
+- `with_alsa` Support for ALSA sound cards. Enables the Volume
+   plugin. Requires the [alsa-mixer] package.  To install the latter,
+   you'll need the [libasound] C library and headers in your system
+   (e.g., install `libasound2-dev` in Debian-based systems).
 
-`with_datezone`
-:    Support for other timezones. Enables the DateZone plugin.
-     Requires [timezone-olson] and [timezone-series] package.
+- `with_datezone` Support for other timezones. Enables the DateZone
+   plugin.  Requires [timezone-olson] and [timezone-series] package.
 
-`with_xpm`
-:    Support for xpm image file format. This will allow loading .xpm files in `<icon>`.
-     Requires the [libXpm] C library.
+- `with_xpm` Support for xpm image file format. This will allow loading
+  .xpm files in `<icon>`.  Requires the [libXpm] C library.
 
-`with_uvmeter`
-:    Enables UVMeter plugin. The plugin shows UV data for Australia. Requires
-     `with_conduit` to connect to HTTPS URLs.
+- `with_uvmeter` Enables UVMeter plugin. The plugin shows UV data for
+   Australia. Requires `with_conduit` to connect to HTTPS URLs.
 
-`with_weather`
-:    Support to display weather information. Enables Weather plugin.
+- `with_weather` Support to display weather information. Enables
+   Weather plugin.
 
-`with_conduit`
-:    Use http-conduit for getting weather data enabling support for http proxies.
-     Requires [http-conduit] and [http-types].
-     Note that this flag has only an effect if `with_weather` is also set.
+- `with_conduit` Use http-conduit for getting weather data enabling
+  support for http proxies.  Requires [http-conduit] and [http-types].
+  Note that this flag has only an effect if `with_weather` is also set.
 
-`all_extensions`
-:    Enables all the extensions above.
+- `all_extensions` Enables all the extensions above.
 
 # Running xmobar
 
@@ -240,140 +227,119 @@ For the output template:
 
 Other configuration options:
 
-`font`
-:    Name of the font to be used. Use the `xft:` prefix for XFT fonts.
-
-`additionalFonts`
-:    Haskell-style list of fonts to be used with the `fn`-template.
-     Use the `xft:` prefix for XFT fonts.
-
-`bgColor`
-:    Background color.
-
-`fgColor`
-:    Default font color.
+- `font` Name of the font to be used. Use the `xft:` prefix for XFT
+  fonts.
 
-`alpha`
-:    The transparency.  0 is transparent, 255 is opaque.
+- `additionalFonts` Haskell-style list of fonts to be used with the
+  `fn`-template.  Use the `xft:` prefix for XFT fonts.
 
-`position`
-:     Top, TopP, TopW, TopSize, Bottom, BottomP, BottomW, BottomSize or Static
-      (with x, y, width and height).
+- `bgColor` Background color.
 
-:     TopP and BottomP take 2 arguments: left padding and right padding.
+- `fgColor` Default font color.
 
-:     TopW and BottomW take 2 arguments: an alignment parameter (L for
-      left, C for centered, R for Right) and an integer for the
-      percentage width xmobar window will have in respect to the
-      screen width.
+- `alpha` The transparency.  0 is transparent, 255 is opaque.
 
-:     TopSize and BottomSize take 3 arguments: an alignment parameter, an
-      integer for the percentage width, and an integer for the minimum pixel
-      height that the xmobar window will have.
+- `position` Top, TopP, TopW, TopSize, Bottom, BottomP, BottomW,
+  BottomSize or Static (with x, y, width and height).
 
-:     For example:
+  TopP and BottomP take 2 arguments: left padding and right padding.
 
-:          position = BottomW C 75
+  TopW and BottomW take 2 arguments: an alignment parameter (L for
+  left, C for centered, R for Right) and an integer for the percentage
+  width xmobar window will have in respect to the screen width.
 
-:     to place xmobar at the bottom, centered with the 75% of the screen width.
+  TopSize and BottomSize take 3 arguments: an alignment parameter, an
+  integer for the percentage width, and an integer for the minimum
+  pixel height that the xmobar window will have.
 
-:     Or:
+  For example:
 
-:          position = BottomP 120 0
+          position = BottomW C 75
 
-:    to place xmobar at the bottom, with 120 pixel indent of the left.
+  to place xmobar at the bottom, centered with the 75% of the screen
+  width.  Or
 
+          position = BottomP 120 0
 
-:     Or
+  to place xmobar at the bottom, with 120 pixel indent of the left.
+  Or
 
-:          position = Static { xpos = 0 , ypos = 0, width = 1024, height = 15 }
+          position = Static { xpos = 0 , ypos = 0, width = 1024, height = 15 }
 
-:     or
+  or
 
-:         position = Top
+          position = Top
 
-`textOffset`
-:     The vertical offset, in pixels, for the text baseline.  If
-      negative or not given, xmobar will try to center text
-      vertically.
+- `textOffset` The vertical offset, in pixels, for the text baseline.
+   If negative or not given, xmobar will try to center text
+   vertically.
 
-`iconOffset`
-:     The vertical offset, in pixels, for icons bottom line.  If negative
-      or not given, xmobar will try to center icons vertically.
+- `iconOffset` The vertical offset, in pixels, for icons bottom line.
+   If negative or not given, xmobar will try to center icons
+   vertically.
 
-`lowerOnStart`
-:     When True the window is sent the bottom of the window stack initially.
+- `lowerOnStart` When True the window is sent the bottom of the window
+  stack initially.
 
-`hideOnStart`
-:     When set to True the window is initially not mapped, i.e. hidden. It then
-      can be toggled manually (for example using the dbus interface) or
-      automatically (by a plugin) to make it reappear.
+- `hideOnStart` When set to True the window is initially not mapped,
+  i.e. hidden. It then can be toggled manually (for example using the
+  dbus interface) or automatically (by a plugin) to make it reappear.
 
-`allDesktops`
-:     When set to True (the default), xmobar will tell the window manager
-      explicitly to be shown in all desktops, by setting
-      `_NET_WM_DESKTOP` to 0xffffffff.
+- `allDesktops` When set to True (the default), xmobar will tell the
+  window manager explicitly to be shown in all desktops, by setting
+  `_NET_WM_DESKTOP` to 0xffffffff.
 
-`overrideRedirect`
-:     If you're running xmobar in a tiling window manager, you might need
-      to set this option to `False` so that it behaves as a docked
-      application.  Defaults to `True`.
+- `overrideRedirect` If you're running xmobar in a tiling window
+  manager, you might need to set this option to `False` so that it
+  behaves as a docked application.  Defaults to `True`.
 
-`pickBroadest`
-:     When multiple displays are available, xmobar will choose by default
-      the first one to place itself.  With this flag set to `True`
-      (the default is `False`) it will choose the broadest one
-      instead.
+- `pickBroadest` When multiple displays are available, xmobar will
+  choose by default the first one to place itself.  With this flag set
+  to `True` (the default is `False`) it will choose the broadest one
+  instead.
 
-`persistent`
-:     When True the window status is fixed i.e. hiding or revealing is not
-      possible. This option can be toggled at runtime. Defaults to False.
+- `persistent` When True the window status is fixed i.e. hiding or
+  revealing is not possible. This option can be toggled at
+  runtime. Defaults to False.
 
-`border`
-:     TopB, TopBM, BottomB, BottomBM, FullB, FullBM or NoBorder (default).
+- `border` TopB, TopBM, BottomB, BottomBM, FullB, FullBM or NoBorder
+  (default).
 
-:     TopB, BottomB, FullB take no arguments, and request drawing a
-      border at the top, bottom or around xmobar's window,
-      respectively.
+  TopB, BottomB, FullB take no arguments, and request drawing a border
+  at the top, bottom or around xmobar's window, respectively.
 
-:     TopBM, BottomBM, FullBM take an integer argument, which is the
-      margin, in pixels, between the border of the window and the
-      drawn border.
+  TopBM, BottomBM, FullBM take an integer argument, which is the
+  margin, in pixels, between the border of the window and the drawn
+  border.
 
-`borderColor`
-:     Border color.
+- `borderColor` Border color.
 
-`borderWidth`
-:     Border width in pixels.
+- `borderWidth` Border width in pixels.
 
-`iconRoot`
-:     Root folder where icons are stored. For <icon=path/>
-      if path start with `"/"`, `"./"` or `"../"` it is interpreted as
-      it is.  Otherwise it will have `iconRoot ++ "/"` prepended to
-      it. Default is `"."`.
+- `iconRoot` Root folder where icons are stored. For <icon=path/> if
+  path start with `"/"`, `"./"` or `"../"` it is interpreted as it is.
+  Otherwise it will have `iconRoot ++ "/"` prepended to it. Default is
+  `"."`.
 
-`commands`
-:    For setting the options of the programs to run (optional).
+- `commands` For setting the options of the programs to run
+  (optional).
 
-`sepChar`
-:    The character to be used for indicating commands in the output
-     template (default '%').
+- `sepChar` The character to be used for indicating commands in the
+  output template (default '%').
 
-`alignSep`
-:    a 2 character string for aligning text in the output template. The
-     text before the first character will be align to left, the text in
-     between the 2 characters will be centered, and the text after the
-     second character will be align to the right.
+- `alignSep` a 2 character string for aligning text in the output
+  template. The text before the first character will be align to left,
+  the text in between the 2 characters will be centered, and the text
+  after the second character will be align to the right.
 
-`template`
-:    The output template.
+- `template` The output template.
 
 
-`wmClass`
-:    The value for the window's X11 WM_CLASS property.  Defaults to "xmobar".
+- `wmClass` The value for the window's X11 WM_CLASS property.
+  Defaults to "xmobar".
 
-`wmName`
-:    The value for the window's X11 WM_NAME property.  Defaults to "xmobar".
+- `wmName` The value for the window's X11 WM_NAME property.  Defaults
+  to "xmobar".
 
 ### Running xmobar with i3status