Merge pull request #7268 from NelleV/Zohreh_master

Kojoley · web-flow · commit 5c7ddee334b1 · 2016-10-15T19:40:32.000+03:00
DOC Numpydoc documentation for def fill()
diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
@@ -4664,44 +4664,44 @@ def barbs(self, *args, **kw):
                         positional_parameter_names=["x", "y", "c"])
     @docstring.dedent_interpd
     def fill(self, *args, **kwargs):
-        """
-        Plot filled polygons.
-
-        Call signature::
+        """Plot filled polygons.
 
-          fill(*args, **kwargs)
-
-        *args* is a variable length argument, allowing for multiple
-        *x*, *y* pairs with an optional color format string; see
-        :func:`~matplotlib.pyplot.plot` for details on the argument
-        parsing.  For example, to plot a polygon with vertices at *x*,
-        *y* in blue.::
+        Parameters
+        ----------
+        args : a variable length argument
+            It allowing for multiple
+            *x*, *y* pairs with an optional color format string; see
+            :func:`~matplotlib.pyplot.plot` for details on the argument
+            parsing.  For example, each of the following is legal::
 
-          ax.fill(x,y, 'b' )
+                ax.fill(x, y)
+                ax.fill(x, y, "b")
+                ax.fill(x, y, "b", x, y, "r")
 
-        An arbitrary number of *x*, *y*, *color* groups can be specified::
+            An arbitrary number of *x*, *y*, *color* groups can be specified::
+            ax.fill(x1, y1, 'g', x2, y2, 'r')
 
-          ax.fill(x1, y1, 'g', x2, y2, 'r')
+        Returns
+        -------
+        a list of :class:`~matplotlib.patches.Patch`
 
-        Return value is a list of :class:`~matplotlib.patches.Patch`
-        instances that were added.
+        Other Parameters
+        ----------------
+        kwargs : :class:`~matplotlib.patches.Polygon` properties
 
+        Notes
+        -----
         The same color strings that :func:`~matplotlib.pyplot.plot`
         supports are supported by the fill format string.
 
         If you would like to fill below a curve, e.g., shade a region
         between 0 and *y* along *x*, use :meth:`fill_between`
 
-        The *closed* kwarg will close the polygon when *True* (default).
-
-        kwargs control the :class:`~matplotlib.patches.Polygon` properties:
-
-        %(Polygon)s
-
-        **Example:**
-
+        Examples
+        --------
         .. plot:: mpl_examples/lines_bars_and_markers/fill_demo.py
 
+
         """
         if not self._hold:
             self.cla()
