matplotlib
diff --git a/‎doc/api/next_api_changes/2018-09-27-AL.rst
Copy file name to clipboard
+4Lines changed: 4 additions & 0 deletions b/‎doc/api/next_api_changes/2018-09-27-AL.rst
Copy file name to clipboard
+4Lines changed: 4 additions & 0 deletions
diff --git a/‎lib/matplotlib/axes/_base.py
Copy file name to clipboardExpand all lines: lib/matplotlib/axes/_base.py
+6-1Lines changed: 6 additions & 1 deletion b/‎lib/matplotlib/axes/_base.py
Copy file name to clipboardExpand all lines: lib/matplotlib/axes/_base.py
+6-1Lines changed: 6 additions & 1 deletion
@@ -0,0 +1,4 @@
+Passing 'normal' to `Axes.axis()` is deprecated
+```````````````````````````````````````````````
+
+Use ``axis('auto')`` instead.
@@ -1267,7 +1267,8 @@ def set_aspect(self, aspect, adjustable=None, anchor=None, share=False):
         matplotlib.axes.Axes.set_anchor
             defining the position in case of extra space.
         """
-        if not (isinstance(aspect, str) and aspect in ('equal', 'auto')):
+        if not (cbook._str_equal(aspect, 'equal')
+                or cbook._str_equal(aspect, 'auto')):
             aspect = float(aspect)  # raise ValueError if necessary
         if share:
             axes = set(self._shared_x_axes.get_siblings(self)
@@ -1649,6 +1650,10 @@ def axis(self, *v, **kwargs):
                 self.set_axis_off()
             elif s in ('equal', 'tight', 'scaled', 'normal',
                        'auto', 'image', 'square'):
+                if s == 'normal':
+                    cbook.warn_deprecated(
+                        "3.1", "Passing 'normal' to axis() is deprecated "
+                        "since %(version)s; use 'auto' instead.")
                 self.set_autoscale_on(True)
                 self.set_aspect('auto')
                 self.autoscale_view(tight=False)