Clean up fancyarrowpatch docstring
Docstring overhaul Small fixes

Docstring overhaul Small fixes
Small style fixes
matplotlib · anntzer · Apr 12, 2017 · dstansby · Mar 17, 2017 · dstansby
diff --git a/lib/matplotlib/patches.py b/lib/matplotlib/patches.py
-        %(AvailableConnectorstyles)s
+        Parameters
+        ----------
+        posA, posB: None, tuple, optional (default: None)
diff --git a/lib/matplotlib/patches.py b/lib/matplotlib/patches.py
+        Parameters
+        ----------
+        posA, posB: None, tuple, optional (default: None)
+            (x,y) co-ordinates of arrow tail and arrow head respectively.
diff --git a/lib/matplotlib/patches.py b/lib/matplotlib/patches.py
 
-        %(AvailableArrowstyles)s
+            %(AvailableArrowstyles)s
diff --git a/lib/matplotlib/patches.py b/lib/matplotlib/patches.py
@@ -3990,10 +3990,10 @@ def __str__(self):
         if self._posA_posB is not None:
             (x1, y1), (x2, y2) = self._posA_posB
             return self.__class__.__name__ \
-                   + "(%g,%g->%g,%g)" % (x1, y1, x2, y2)
diff --git a/lib/matplotlib/patches.py b/lib/matplotlib/patches.py
                  **kwargs):
         """
-        If *posA* and *posB* is given, a path connecting two point are
-        created according to the connectionstyle. The path will be
+        If *posA* and *posB* are given, a path connecting two points are
diff --git a/lib/matplotlib/patches.py b/lib/matplotlib/patches.py
+        shrinkA, shrinkB: scalar, optional (default: 2)
+
+        mutation_scale: scalar, optional (default: 1)
+            Value with which attributes of arrowstyle (e.g., head_length)
diff --git a/lib/matplotlib/patches.py b/lib/matplotlib/patches.py
@@ -4075,28 +4106,40 @@ def __init__(self, posA=None, posB=None,
         self._mutation_aspect = mutation_aspect
 
         self.set_dpi_cor(dpi_cor)
-        #self._draw_in_display_coordinate = True
+        # self._draw_in_display_coordinate = True
diff --git a/lib/matplotlib/patches.py b/lib/matplotlib/patches.py
+
+        Parameters
+        ----------
+        connectionstyle: None, ConnectionStyle instance, or string
diff --git a/lib/matplotlib/patches.py b/lib/matplotlib/patches.py
         """
         return self._connector
 
     def set_arrowstyle(self, arrowstyle=None, **kw):
         """
-        Set the arrow style.
+        Set the arrow style. Old attributes are forgotten. Without arguments
+        (or with `arrowstyle=None`) returns available box styles as a list of
diff --git a/lib/matplotlib/patches.py b/lib/matplotlib/patches.py
-        *mutation_aspect* : The height of the rectangle will be
-            squeezed by this value before the mutation and the mutated
-            box will be stretched by the inverse of it. default=None.
+        arrow_transmuter :
diff --git a/lib/matplotlib/patches.py b/lib/matplotlib/patches.py
 
+        connector :
diff --git a/lib/matplotlib/patches.py b/lib/matplotlib/patches.py
+            Head and tail patch respectively. :class:`matplotlib.patch.Patch`
+            instance.
+
+        shrinkA, shrinkB : scalar, optional (default: 2)
diff --git a/lib/matplotlib/patches.py b/lib/matplotlib/patches.py
+        ----------
+        connectionstyle : None, ConnectionStyle instance, or string
+            Can be a string with connectionstyle name with
+            optional comma-separated attributes, eg::
diff --git a/lib/matplotlib/patches.py b/lib/matplotlib/patches.py
 
-         set_connectionstyle("arc,angleA=0,armA=30,rad=10")
-         set_connectionstyle("arc", angleA=0,armA=30,rad=10)
+            Alternatively, the attributes can be provided as keywords, eg::
diff --git a/lib/matplotlib/patches.py b/lib/matplotlib/patches.py
+        ----------
+        arrowstyle : None, ArrowStyle, str, optional (default: None)
+            Can be a string with arrowstyle name with optional comma-separated
+            attributes, eg.::
diff --git a/lib/matplotlib/patches.py b/lib/matplotlib/patches.py
 
-        Old attrs simply are forgotten.
+            Alternatively attributes can be provided as keywords, eg.::
diff --git a/lib/matplotlib/patches.py b/lib/matplotlib/patches.py
         """
         self._mutation_scale = scale
         self.stale = True
 
     def get_mutation_scale(self):
         """
         Return the mutation scale.
+
+        Returns
+        ----------