summaryrefslogtreecommitdiffhomepage
path: root/README
diff options
context:
space:
mode:
authorMartin Perner <martin@perner.cc>2011-10-27 20:51:19 +0200
committerMartin Perner <martin@perner.cc>2011-10-27 22:46:28 +0200
commitf6bb8eb4c4350522367f4ab2dacbfeb0a99cd06d (patch)
tree304e4ca8230f78cb659dff9a4aeadd1f65242e85 /README
parent9718dabe6c6d5979e3f6837ef04a39d3ad8c786c (diff)
downloadxmobar-f6bb8eb4c4350522367f4ab2dacbfeb0a99cd06d.tar.gz
xmobar-f6bb8eb4c4350522367f4ab2dacbfeb0a99cd06d.tar.bz2
DateZone, Date*L Plugin merges; DateZone API-Change!
To support multiple locales, an lock was introduced. Although through this, supporting DateL and DateZoneL would be cumbersome. To simplify the usage, DateZone was replaced with DateZoneL. Additionally the position of the Alias parameter was changed. Using "" as Zone parameter for DateZoneL simulates DateL. Providing also "" for locale simulates Date.
Diffstat (limited to 'README')
-rw-r--r--README33
1 files changed, 9 insertions, 24 deletions
diff --git a/README b/README
index 48c48ed..f6d0ac0 100644
--- a/README
+++ b/README
@@ -125,7 +125,7 @@ Otherwise, you'll need to install them yourself.
[alsa-mixer] package.
`with_datezone`
-: Support for other timezones. Enables the DateZone and DateZoneL plugin.
+: Support for other timezones. Enables the DateZone plugin.
Requires [timezone-olson] and [timezone-series] package.
`all_extensions`
@@ -872,33 +872,18 @@ can be used in the output template as `%mydate%`
`strftime` function (or Haskell's `formatCalendarTime`).
- Sample usage: `Run Date "%a %b %_d %Y <fc=#ee9a00>%H:%M:%S</fc>" "date" 10`
-`DateZone Format Alias Zone 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`).
-- Zone is the name of the TimeZone. Assumes that the tz database is stored in
- /usr/share/zoneinfo/
-- Sample usage:
- `Run DateZone "<fc=#ee9a00>%H:%M:%S</fc>" "viennaDate" "Europa/Vienna" 10`
-
-`DateL Format Locale Alias RefreshRate`
-
-- Behaves as Date but localizes the output
- If Locale is "" the default locale of the system is used, otherwise the given
- locale
-- As this plugin calls `setlocale`, there can only be one locale used, besides
- English (default of Haskell, used in Date and DateZone) with DateL and
- DateZoneL. If multiple plugin instances, with different locales, are used
- the result is a race condition, but consistent between all plugins.
-- Usage with system locale:
- `Run DateL "%B" "" "date" 10`
-- Usage with german locale:
- `Run DateL "%B" "de_DE.UTF-8" "date" 10`
-
-`DateZoneL Format Locale Alias Zone RefreshRate`
-
-- Behaves as DateZone but localizes the output
-- Please check DateL for information's about Locale
+ locale. If there are more instances of DateZone, using "" as input for Locacle
+ is not recommended.
+- Zone is the name of the TimeZone. It is assumed that the tz database is stored
+ in /usr/share/zoneinfo/. If "" is given as Zone, the default system time is
+ used.
+- Sample usage:
+ `Run DateZone "<fc=#ee9a00>%H:%M:%S</fc>" "GMT+1" "Europe/Vienna" "viennaTime" 10`
`CommandReader "/path/to/program" Alias`