From 7f35454cc112ec24cf7381358932b7ea2ec0598d Mon Sep 17 00:00:00 2001 From: jao Date: Sat, 12 Oct 2019 04:40:29 +0100 Subject: Docs format --- changelog.md | 2 +- readme.md | 60 +++++++++++++++++++++++++++++++----------------------------- 2 files changed, 32 insertions(+), 30 deletions(-) diff --git a/changelog.md b/changelog.md index 0803624..233bd7f 100644 --- a/changelog.md +++ b/changelog.md @@ -1,4 +1,4 @@ -## Version 0.31 +## Version 0.31 (October, 2019) _New features_ diff --git a/readme.md b/readme.md index cc0f061..747cbe8 100644 --- a/readme.md +++ b/readme.md @@ -198,11 +198,11 @@ For the output template: managers to feed xmobar strings with `` tags mixed with un-trusted content (e.g. window titles). For example, if xmobar is invoked as - ```xmobar -c "[Run UnsafeStdinReader]" -t "%UnsafeStdinReader%"``` + xmobar -c "[Run UnsafeStdinReader]" -t "%UnsafeStdinReader%" and receives on standard input the line - ```foo/>``` + foo/>` then it will display the text ```foo```, which, when clicked, will cause `test` to be echoed. @@ -1159,29 +1159,33 @@ more than one battery. ### `Alsa Mixer Element Args` -Like [Volume](#volume-mixer-element-args-refreshrate), but with the following differences: -- Uses event-based refreshing via `alsactl monitor` instead of polling, so it will refresh - instantly when there's a volume change, and won't use CPU until a change happens. -- Aliases to `alsa:` followed by the mixer name and element name separated by a colon. Thus, - `Alsa "default" "Master" []` can be used as `%alsa:default:Master%`. +Like [Volume](#volume-mixer-element-args-refreshrate), but with the +following differences: +- Uses event-based refreshing via `alsactl monitor` instead of + polling, so it will refresh instantly when there's a volume change, + and won't use CPU until a change happens. +- Aliases to `alsa:` followed by the mixer name and element name + separated by a colon. Thus, `Alsa "default" "Master" []` can be used + as `%alsa:default:Master%`. - Additional options (after the `--`): - `--alsactl=/path/to/alsactl` - - If this option is not specified, `alsactl` will be sought in your `PATH` - first, and failing that, at `/usr/sbin/alsactl` (this is its location on - Debian systems. `alsactl monitor` works as a non-root user despite living - in `/usr/sbin`.). -- `stdbuf` (from coreutils) must be (and most probably already is) in your `PATH`. + - If this option is not specified, `alsactl` will be sought in + your `PATH` first, and failing that, at `/usr/sbin/alsactl` + (this is its location on Debian systems. `alsactl monitor` + works as a non-root user despite living in `/usr/sbin`.). +- `stdbuf` (from coreutils) must be (and most probably already is) in + your `PATH`. ### `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). - Aliases to `mpd` -- Args: default monitor arguments. In addition you can provide - `-P`, `-S` and `-Z`, with an string argument, to represent the - playing, stopped and paused states in the `statei` template field. - The environment variables `MPD_HOST` and `MPD_PORT` are used to configure the - mpd server to communicate with. Also available: +- Args: default monitor arguments. In addition you can provide `-P`, + `-S` and `-Z`, with an string argument, to represent the playing, + stopped and paused states in the `statei` template field. The + environment variables `MPD_HOST` and `MPD_PORT` are used to + configure the mpd server to communicate with. Also available: - `lapsed-icon-pattern`: dynamic string for current track position in `ipat`. - Variables that can be used with the `-t`/`--template` argument: `bar`, `vbar`, `ipat`, `state`, `statei`, `volume`, `length`, @@ -1405,7 +1409,7 @@ will display "N/A" if for some reason the `date` invocation fails. ## Other Plugins -**`StdinReader`** +### `StdinReader` - Aliases to StdinReader - Displays any text received by xmobar on its standard input. @@ -1413,7 +1417,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. @@ -1427,13 +1431,13 @@ will display "N/A" if for some reason the `date` invocation fails. clicking on xmobar: ```ws1 ws2``` -**`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 %H:%M:%S" "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`). @@ -1446,17 +1450,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 @@ -1466,9 +1470,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 @@ -1500,7 +1502,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 @@ -1518,7 +1520,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 `