matplotlib
diff --git a/‎lib/matplotlib/axes/_axes.py
Copy file name to clipboardExpand all lines: lib/matplotlib/axes/_axes.py
+17-14Lines changed: 17 additions & 14 deletions b/‎lib/matplotlib/axes/_axes.py
Copy file name to clipboardExpand all lines: lib/matplotlib/axes/_axes.py
+17-14Lines changed: 17 additions & 14 deletions
@@ -4668,25 +4668,28 @@ def fill(self, *args, **kwargs):
 
 	Parameters
 	----------
-        args : a variable length argument, allowing for multiple
+        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, to plot a polygon with vertices at *x*,
-            *y* in blue.::
-            ax.fill(x,y, 'b' )
+            parsing.  For example, each of the following is legal::
+
+                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::
             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
-
+        Returns
+        -------
+	a list of :class:`~matplotlib.patches.Patch`
 
-        Return 
-	------
-	Return value is a list of :class:`~matplotlib.patches.Patch`
-        instances that were added.
+        Other Parameters
+        ----------------
+        kwargs : :class:`~matplotlib.patches.Polygon` properties
 
+        %(Polygons)
 
 	Notes
 	-----
@@ -4696,12 +4699,12 @@ def fill(self, *args, **kwargs):
         If you would like to fill below a curve, e.g., shade a region
         between 0 and *y* along *x*, use :meth:`fill_between`
 
-       
+
         Example
 	-------
-
         .. plot:: mpl_examples/lines_bars_and_markers/fill_demo.py
 
+
         """
         if not self._hold:
             self.cla()