DOC: sync order of axes.pie args to call sig

phobson · phobson · commit 08d2a5e7480c · 2017-03-24T09:23:54.000-07:00
diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
@@ -2478,73 +2478,73 @@ def pie(self, x, explode=None, labels=None, colors=None,
         r"""Plot a pie chart.
 
         Make a pie chart of array *x*.  The fractional area of each
-        wedge is given by x/sum(x).  If sum(x) <= 1, then the values
-        of x give the fractional area directly and the array will not
-        be normalized.  The wedges are plotted counterclockwise,
-        by default starting from the x-axis.
+        wedge is given by ``x/sum(x)``.  If ``sum(x) <= 1``, then the
+        values of x give the fractional area directly and the array
+        will not be normalized.  The wedges are plotted
+        counterclockwise, by default starting from the x-axis.
 
         Parameters
         ----------
-        x : array
+        x : array-like
             The input array used to make the pie chart.
 
-        explode : None or array
+        explode : array-like, optional (default is None)
             If not *None*, is a ``len(x)`` array which specifies the
             fraction of the radius with which to offset each wedge.
 
-        colors : None or array
+        labels : list, optional (default is None)
+            A sequence of strings providing the labels for each wedge
+
+        colors : array-like, optional (default is None)
             A sequence of matplotlib color args through which the pie chart
             will cycle.  If `None`, will use the colors in the currently
             active cycle.
 
-        labels : None or list
-            A sequence of strings providing the labels for each wedge
-
-        autopct : None or string or function
+        autopct : None (default), string, or function, optional
             If not *None*, is a string or function used to label the wedges
             with their numeric value.  The label will be placed inside the
             wedge.  If it is a format string, the label will be ``fmt%pct``.
             If it is a function, it will be called.
 
-        pctdistance : float
+        pctdistance : float, optional (default is 0.6)
             The ratio between the center of each pie slice and the
             start of the text generated by *autopct*.  Ignored if
             *autopct* is *None*; default is 0.6.
 
-        labeldistance : float
-            The radial distance at which the pie labels are drawn
-
-        shadow : bool
+        shadow : bool, optional (default is False)
             Draw a shadow beneath the pie.
 
-        startangle : None or float
+        labeldistance : float, optional (default is 1.1)
+            The radial distance at which the pie labels are drawn
+
+        startangle : float, optional (default is None)
             If not *None*, rotates the start of the pie chart by *angle*
             degrees counterclockwise from the x-axis.
 
-        radius : None or float
-          The radius of the pie, if *radius* is *None* it will be set to 1.
+        radius : float, optional (default is None)
+            The radius of the pie, if *radius* is *None* it will be set to 1.
 
-        counterclock : bool
+        counterclock : bool, optional (default is True)
             Specify fractions direction, clockwise or counterclockwise.
 
-        wedgeprops : None or dict
+        wedgeprops : dict, optional (default is None)
             Dict of arguments passed to the wedge objects making the pie.
-            For example, you can pass in wedgeprops = { 'linewidth' : 3 }
+            For example, you can pass in``wedgeprops = {'linewidth': 3}``
             to set the width of the wedge border lines equal to 3.
             For more details, look at the doc/arguments of the wedge object.
-            By default `clip_on=False`.
+            By default ``clip_on=False``.
 
-        textprops : None or dict
+        textprops : dict, optional (default is None)
             Dict of arguments to pass to the text objects.
 
-        center :  list of float
-          Center position of the chart. Takes value (0,0) or is a sequence
-          of 2 scalars.
+        center :  list of float, optional (default is (0, 0))
+            Center position of the chart. Takes value (0, 0) or is a
+            sequence of 2 scalars.
 
-        frame : bool
+        frame : bool, optional (default is False)
             Plot axes frame with the chart if true.
 
-        rotatelabels : bool
+        rotatelabels : bool, optional (default is False)
             Rotate each label to the angle of the corresponding slice if true.
 
         Returns
@@ -2565,10 +2565,8 @@ def pie(self, x, explode=None, labels=None, colors=None,
         The pie chart will probably look best if the figure and axes are
         square, or the Axes aspect is equal.
 
-        >>> figure(figsize=(8,8))
-        >>> ax = axes([0.1, 0.1, 0.8, 0.8])
+        .. plot:: mpl_examples/pie_and_polar_charts/pie_demo_features.py
 
-        >>> axes(aspect=1)
 
         """
 
