matplotlib
diff --git a/‎doc/api/axis_api.rst
Copy file name to clipboardExpand all lines: doc/api/axis_api.rst
+1Lines changed: 1 addition & 0 deletions b/‎doc/api/axis_api.rst
Copy file name to clipboardExpand all lines: doc/api/axis_api.rst
+1Lines changed: 1 addition & 0 deletions
diff --git a/‎doc/api/next_api_changes/deprecations/18710-TH.rst
Copy file name to clipboard
+5Lines changed: 5 additions & 0 deletions b/‎doc/api/next_api_changes/deprecations/18710-TH.rst
Copy file name to clipboard
+5Lines changed: 5 additions & 0 deletions
diff --git a/‎lib/matplotlib/axes/_base.py
Copy file name to clipboardExpand all lines: lib/matplotlib/axes/_base.py
+3-3Lines changed: 3 additions & 3 deletions b/‎lib/matplotlib/axes/_base.py
Copy file name to clipboardExpand all lines: lib/matplotlib/axes/_base.py
+3-3Lines changed: 3 additions & 3 deletions
diff --git a/‎lib/matplotlib/axis.py
Copy file name to clipboardExpand all lines: lib/matplotlib/axis.py
+19-3Lines changed: 19 additions & 3 deletions b/‎lib/matplotlib/axis.py
Copy file name to clipboardExpand all lines: lib/matplotlib/axis.py
+19-3Lines changed: 19 additions & 3 deletions
diff --git a/‎lib/matplotlib/spines.py
Copy file name to clipboardExpand all lines: lib/matplotlib/spines.py
+7-3Lines changed: 7 additions & 3 deletions b/‎lib/matplotlib/spines.py
Copy file name to clipboardExpand all lines: lib/matplotlib/spines.py
+7-3Lines changed: 7 additions & 3 deletions
@@ -40,6 +40,7 @@ Inheritance
    :template: autosummary.rst
    :nosignatures:
 
+   Axis.clear
    Axis.cla
    Axis.get_scale
 
 
@@ -0,0 +1,5 @@
+``Axis.cla()`` and ``Spine.cla()``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+``Axis.cla()`` and ``Spine.cla()`` are deprecated in favor of the respective
+``clear()`` methods.
@@ -1100,11 +1100,11 @@ def cla(self):
         xaxis_visible = self.xaxis.get_visible()
         yaxis_visible = self.yaxis.get_visible()
 
-        self.xaxis.cla()
-        self.yaxis.cla()
+        self.xaxis.clear()
+        self.yaxis.clear()
 
         for name, spine in self.spines.items():
-            spine.cla()
+            spine.clear()
 
         self.ignore_existing_data_limits = True
         self.callbacks = cbook.CallbackRegistry()
 
@@ -705,7 +705,7 @@ def __init__(self, axes, pickradius=15):
         self._major_tick_kw = dict()
         self._minor_tick_kw = dict()
 
-        self.cla()
+        self.clear()
         self._set_scale('linear')
 
     # During initialization, Axis objects often create ticks that are later
@@ -768,8 +768,19 @@ def get_children(self):
         return [self.label, self.offsetText,
                 *self.get_major_ticks(), *self.get_minor_ticks()]
 
-    def cla(self):
-        """Clear this axis."""
+    def clear(self):
+        """
+        Clear the axis.
+
+        This resets axis properties to their default values:
+
+        - the label
+        - the scale
+        - locators, formatters and ticks
+        - major and minor grid
+        - units
+        - registered callbacks
+        """
 
         self.label.set_text('')  # self.set_label_text would change isDefault_
 
@@ -793,6 +804,11 @@ def cla(self):
         self.set_units(None)
         self.stale = True
 
+    @cbook.deprecated("3.4", alternative="Axis.clear()")
+    def cla(self):
+        """Clear this axis."""
+        return self.clear()
+
     def reset_ticks(self):
         """
         Re-initialize the major and minor Tick lists.
 
@@ -228,14 +228,18 @@ def register_axis(self, axis):
         """
         self.axis = axis
         if self.axis is not None:
-            self.axis.cla()
+            self.axis.clear()
         self.stale = True
 
-    def cla(self):
+    def clear(self):
         """Clear the current spine."""
         self._position = None  # clear position
         if self.axis is not None:
-            self.axis.cla()
+            self.axis.clear()
+
+    @cbook.deprecated("3.4", alternative="Spine.clear()")
+    def cla(self):
+        self.clear()
 
     def _adjust_location(self):
         """Automatically set spine bounds to the view interval."""