Fix some issues with docstring rendering

afvincent · afvincent · commit e70e5fd362ee · 2017-03-20T01:09:04.000+01:00
diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
@@ -1113,11 +1113,12 @@ def eventplot(self, positions, orientation='horizontal', lineoffsets=1,
             *orientation* parameter).
 
         orientation : {'horizontal', 'vertical'}, optional
+            Controls the direction of the event collections:
 
-            * 'horizontal' : the lines are arranged horizontally in rows,
-            and are vertical.
-            * 'vertical' : the lines are arranged vertically in columns,
-            and are horizontal.
+                - 'horizontal' : the lines are arranged horizontally in rows,
+                  and are vertical.
+                - 'vertical' : the lines are arranged vertically in columns,
+                  and are horizontal.
 
         lineoffsets : scalar or sequence of scalars, optional, default: 1
             The offset of the center of the lines from the origin, in the
@@ -1150,18 +1151,21 @@ def eventplot(self, positions, orientation='horizontal', lineoffsets=1,
             :class:`~matplotlib.collections.LineCollection` for a list of
             the valid properties.
 
-        For *linelengths*, *linewidths*, *colors*, and *linestyles*, if only
-        a single value is given, that value is applied to all lines.  If an
-        array-like is given, it must have the same length as positions, and
-        each value will be applied to the corresponding row or column of
-        events.
-
         Returns
         -------
 
         A list of :class:`matplotlib.collections.EventCollection` objects that
         were added.
 
+        Notes
+        -----
+
+        For *linelengths*, *linewidths*, *colors*, and *linestyles*, if only
+        a single value is given, that value is applied to all lines.  If an
+        array-like is given, it must have the same length as *positions*, and
+        each value will be applied to the corresponding row or column of
+        events.
+
         Example
         -------
 
