From b6080422daa5dfa4664e008d02b0a9dedf324f6f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Luk=C3=A1=C5=A1=20Mand=C3=A1k?= <lucky@cock.li>
Date: Mon, 13 Apr 2015 15:51:05 +0200
Subject: [PATCH] Updated docs.

---
 i3pystatus/clock.py | 36 ++++++++++++++++++++++++++++++++----
 1 file changed, 32 insertions(+), 4 deletions(-)

diff --git a/i3pystatus/clock.py b/i3pystatus/clock.py
index 33df881..bb0780f 100644
--- a/i3pystatus/clock.py
+++ b/i3pystatus/clock.py
@@ -10,7 +10,7 @@ from i3pystatus import IntervalModule
 
 class Clock(IntervalModule):
     """
-    This class shows a clock
+    This class shows a clock.
 
     format can be passed in four different ways:
 
@@ -18,11 +18,39 @@ class Clock(IntervalModule):
     - one two-tuple, first is the format, second the timezone
     - list of strings - no timezones
     - list of two tuples, first is the format, second is timezone
+
+    Use mousewheel to cycle between formats.
+
+    For complete time format specification see:
+
+    ::
+
+        man strftime
+
+    All available timezones are located in directory:
+
+    ::
+
+        /usr/share/zoneinfo/
+
+    .. rubric:: Format examples
+
+    ::
+
+        # one format, local timezone
+        format = '%a %b %-d %b %X'
+        # multiple formats, local timezone
+        format = [ '%a %b %-d %b %X', '%X' ]
+        # one format, specified timezone
+        format = ('%a %b %-d %b %X', 'Europe/Bratislava')
+        # multiple formats, specified timezones
+        format = [ ('%a %b %-d %b %X', 'America/New_York'), ('%X', 'Etc/GMT+9') ]
+
     """
 
     settings = (
-        ("format", "`None` means to use the default, locale-dependent format. Can cycle between formats with mousewheel"),
-        ("color", "RGB hexadecimal code color specifier, default to #ffffff, set to `i3Bar` to use i3 bar default"),
+        ("format", "`None` means to use the default, locale-dependent format."),
+        ("color", "RGB hexadecimal code color specifier, default to #ffffff"),
     )
     format = None
     color = "#ffffff"
@@ -75,7 +103,7 @@ class Clock(IntervalModule):
         return [expand_format(format_) for format_ in formats]
 
     def run(self):
-        # set correct timezone
+        # set timezone
         if time.tzname[0] is not self.format[self.current_format_id][1]:
             os.environ.putenv('TZ', self.format[self.current_format_id][1])
             time.tzset()