Changed docstrings as tacaswell suggested

lennart0901 · lennart0901 · commit c2305c98dd22 · 2014-10-19T11:29:02.000+02:00
diff --git a/lib/matplotlib/collections.py b/lib/matplotlib/collections.py
@@ -463,9 +463,12 @@ def set_linestyle(self, ls):
         """
         Set the linestyle(s) for the collection.
 
-        ACCEPTS: [ '-' | '--' | '-.' | ':' |
-        'solid' | 'dashed', 'dashdot', 'dotted' |
-        (offset, on-off-dash-seq) ]
+
+        Parameters
+        ----------
+        ls : { '-',  '--', '-.', ':' , 'solid', 'dashed', 'dashdot', 'dotted',
+               (offset, on-off-dash-seq)}
+            The line style.  [[EXPLAIN on-off-dash-seq]]
         """
         try:
             dashd = backend_bases.GraphicsContextBase.dashd
diff --git a/lib/matplotlib/lines.py b/lib/matplotlib/lines.py
@@ -909,17 +909,17 @@ def set_linestyle(self, linestyle):
         Set the linestyle of the line (also accepts drawstyles)
 
 
-        ================              =================
+        ===========================   =================
         linestyle                     description
-        ================              =================
+        ===========================   =================
         ``'-'`` or ``'solid'``        solid line
         ``'--'`` or  ``'dashed'``     dashed line
         ``'-.'`` or  ``'dash_dot'``   dash-dotted line
         ``':'`` or ``'dotted'``       dotted line
         ``'None'``                    draw nothing
         ``' '``                       draw nothing
         ``''``                        draw nothing
-        ================              =================
+        ===========================   =================
 
         'steps' is equivalent to 'steps-pre' and is maintained for
         backward-compatibility.
@@ -929,10 +929,13 @@ def set_linestyle(self, linestyle):
             :meth:`set_drawstyle`
                To set the drawing style (stepping) of the plot.
 
-        ACCEPTS: [``'-'`` | ``'--'`` | ``'-.'`` | ``':'`` |
-                  ``'solid'`` | ``'dashed'`` | ``'dash_dot'`` | ``'dotted'`` |
-                  ``'None'`` | ``' '`` | ``''``]
-        and any drawstyle in combination with a linestyle, e.g., ``'steps--'``.
+        Parameters
+        ----------
+        ls : { '-',  '--', '-.', ':' , 'solid', 'dashed', 'dashdot', 'dotted',
+               (offset, on-off-dash-seq)}
+            The line style.  [[EXPLAIN on-off-dash-seq]]
+            Also accepts any drawstyle in combination with a linestyle,
+            e.g., ``'steps--'``.
         """
         if not is_string_like(linestyle):
             if len(linestyle) != 2:
diff --git a/lib/matplotlib/patches.py b/lib/matplotlib/patches.py
@@ -339,9 +339,11 @@ def set_linestyle(self, ls):
         """
         Set the patch linestyle
 
-        ACCEPTS: ['-' | '--' | '-.' | ':' |
-        'solid' | 'dashed' | 'dashdot' | 'dotted' |
-        (offset, on-off-dash-seq) ]
+        Parameters
+        ----------
+        ls : { '-',  '--', '-.', ':' , 'solid', 'dashed', 'dashdot', 'dotted',
+               (offset, on-off-dash-seq)}
+            The line style.  [[EXPLAIN on-off-dash-seq]]
         """
         if ls is None:
             ls = "solid"
