documentation for def fill()

ZohrehPythonSchool · NelleV · commit b33e1912522b · 2016-10-13T12:32:41.000-07:00
diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
@@ -4664,41 +4664,41 @@ def barbs(self, *args, **kw):
                         positional_parameter_names=["x", "y", "c"])
     @docstring.dedent_interpd
     def fill(self, *args, **kwargs):
-        """
-        Plot filled polygons.
-
-        Call signature::
-
-          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.::
-
-          ax.fill(x,y, 'b' )
-
-        An arbitrary number of *x*, *y*, *color* groups can be specified::
-
-          ax.fill(x1, y1, 'g', x2, y2, 'r')
-
-        Return value is a list of :class:`~matplotlib.patches.Patch`
+        """Plot filled polygons.
+
+	Parameters
+	----------
+        args : 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.::
+            ax.fill(x,y, 'b' )
+            An arbitrary number of *x*, *y*, *color* groups can be specified::
+            ax.fill(x1, y1, 'g', x2, y2, 'r')
+
+ 	kwargs : The *closed* kwarg will close the polygon when *True* (default).
+            kwargs control the :class:`~matplotlib.patches.Polygon` properties:
+            %(Polygon)s
+
+
+        Return 
+	------
+	Return value is a list of :class:`~matplotlib.patches.Patch`
         instances that were added.
 
+
+	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:**
+       
+        Example
+	-------
 
         .. plot:: mpl_examples/lines_bars_and_markers/fill_demo.py
 
@@ -4715,6 +4715,8 @@ def fill(self, *args, **kwargs):
         self.autoscale_view()
         return patches
 
+
+
     @_preprocess_data(replace_names=["x", "y1", "y2", "where"],
                          label_namer=None)
     @docstring.dedent_interpd
