Maintain data=None in plot()'s explicit signature.

anntzer · anntzer · commit ec13742c8efd · 2018-09-10T10:11:47.000+02:00
diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
@@ -1325,7 +1325,7 @@ def eventplot(self, positions, orientation='horizontal', lineoffsets=1,
     # Uses a custom implementation of data-kwarg handling in
     # _process_plot_var_args.
     @docstring.dedent_interpd
-    def plot(self, *args, scalex=True, scaley=True, **kwargs):
+    def plot(self, *args, scalex=True, scaley=True, data=None, **kwargs):
         """
         Plot y versus x as lines and/or markers.
 
@@ -1550,7 +1550,7 @@ def plot(self, *args, scalex=True, scaley=True, **kwargs):
 
         """
         kwargs = cbook.normalize_kwargs(kwargs, mlines.Line2D._alias_map)
-        lines = [*self._get_lines(*args, **kwargs)]
+        lines = [*self._get_lines(*args, data=data, **kwargs)]
         for line in lines:
             self.add_line(line)
         self.autoscale_view(scalex=scalex, scaley=scaley)
@@ -1936,7 +1936,7 @@ def xcorr(self, x, y, normed=True, detrend=mlab.detrend_none,
     #### Specialized plotting
 
     # @_preprocess_data() # let 'plot' do the unpacking..
-    def step(self, x, y, *args, where='pre', **kwargs):
+    def step(self, x, y, *args, where='pre', data=None, **kwargs):
         """
         Make a step plot.
 
@@ -2002,7 +2002,7 @@ def step(self, x, y, *args, where='pre', **kwargs):
                              "'pre', 'post' or 'mid'")
         kwargs['linestyle'] = 'steps-' + where + kwargs.get('linestyle', '')
 
-        return self.plot(x, y, *args, **kwargs)
+        return self.plot(x, y, *args, data=data, **kwargs)
 
     @_preprocess_data()
     @docstring.dedent_interpd
@@ -4816,7 +4816,7 @@ def barbs(self, *args, **kw):
 
     # Uses a custom implementation of data-kwarg handling in
     # _process_plot_var_args.
-    def fill(self, *args, **kwargs):
+    def fill(self, *args, data=None, **kwargs):
         """
         Plot filled polygons.
 
@@ -4839,6 +4839,13 @@ def fill(self, *args, **kwargs):
                 ax.fill(x, y, x2, y2)            # two polygons
                 ax.fill(x, y, "b", x2, y2, "r")  # a blue and a red polygon
 
+        data : indexable object, optional
+            An object with labelled data. If given, provide the label names to
+            plot in *x* and *y*, e.g.::
+
+                ax.fill("time", "signal",
+                        data={"time": [0, 1, 2], "signal": [0, 1, 0]})
+
         Returns
         -------
         a list of :class:`~matplotlib.patches.Polygon`
@@ -4856,7 +4863,7 @@ def fill(self, *args, **kwargs):
         kwargs = cbook.normalize_kwargs(kwargs, mlines.Line2D._alias_map)
 
         patches = []
-        for poly in self._get_patches_for_fill(*args, **kwargs):
+        for poly in self._get_patches_for_fill(*args, data=data, **kwargs):
             self.add_patch(poly)
             patches.append(poly)
         self.autoscale_view()
