cores: timer: clean up wording for timer documentation

This fixes some formatting errors with the timer documentation, such as
the lack of a space between the first and second sentences.  It also
fixes some grammar for documentation of various fields.

Signed-off-by: Sean Cross <sean@xobs.io>

litex/soc/cores/timer.py

@@ -48,17 +48,18 @@ class Timer(Module, AutoCSR, ModuleDoc):
     CPU can also do software polling with ``update_value`` and ``value`` to know the elapsed duration)
     """
     def __init__(self, width=32):
-        self._load = CSRStorage(width, description="""Load value when Timer is (re-)enabled.""" +
+        self._load = CSRStorage(width, description="""Load value when Timer is (re-)enabled.
-            """In One-Shot mode, the value written to this register specify the Timer's duration in
+            In One-Shot mode, the value written to this register specifies the Timer's duration in
             clock cycles.""")
-        self._reload = CSRStorage(width, description="""Reload value when Timer reaches 0.""" +
+        self._reload = CSRStorage(width, description="""Reload value when Timer reaches ``0``.
-            """In Periodic mode, the value written to this register specify the Timer's period in
+            In Periodic mode, the value written to this register specify the Timer's period in
             clock cycles.""")
-        self._en = CSRStorage(1, description="""Enable of the Timer.""" +
+        self._en = CSRStorage(1, description="""Enable flag of the Timer.
-            """Set if to 1 to enable/start the Timer and 0 to disable the Timer""")
+            Set this flag to ``1`` to enable/start the Timer.  Set to ``0`` to disable the Timer.""")
-        self._update_value = CSRStorage(1, description="""Update of the current countdown value."""+
+        self._update_value = CSRStorage(1, description="""Update trigger for the current countdown value.
-            """A write to this register latches the current countdown value to `value` register.""")
+            A write to this register latches the current countdown value to ``value`` register.""")
-        self._value = CSRStatus(width, description="""Latched countdown value""")
+        self._value = CSRStatus(width, description="""Latched countdown value.
+            This value is updated by writing to ``update_value``.""")
 
         self.submodules.ev = EventManager()
         self.ev.zero       = EventSourceProcess()