document labelvisibility on shared axes change (rev1)

ImportanceOfBeingErnest · ImportanceOfBeingErnest · commit 89779532dad7 · 2018-04-08T22:14:32.000+02:00
diff --git a/doc/api/api_changes.rst b/doc/api/api_changes.rst
@@ -410,11 +410,17 @@ direction) is visible, to avoid making irreversible changes to the figure.
 Ticklabels are turned off instead of being invisible
 ----------------------------------------------------
 
-Internally, :func:`~matplotlib.axis.Axis.set_tick_params` is now used to
-hide tick labels instead of setting the visibility on the tick label objects.
+Internally, the `Tick`'s :func:`~matplotlib.axis.Tick.label1On` attribute
+is now used to hide tick labels instead of setting the visibility on the tick
+label objects.
 This improves overall performance and fixes some issues.
-As a consequence, in case those labels ought to be shown, `set_tick_params`
-needs to be used, e.g. `ax.xaxis.set_tick_params(labelbottom=True)`.
+As a consequence, in case those labels ought to be shown,
+:func:`~matplotlib.axes.Axes.tick_params`
+needs to be used, e.g.
+
+::
+
+    ax.tick_params(labelbottom=True)
 
 
 Removal of warning on empty legends
diff --git a/doc/users/prev_whats_new/whats_new_2.1.0.rst b/doc/users/prev_whats_new/whats_new_2.1.0.rst
@@ -395,22 +395,28 @@ cases.
 ---------------------------------------------------
 
 Bulk setting of tick label rotation is now possible via
-:func:`~matplotlib.axis.Axis.set_tick_params` using the ``rotation``
+:func:`~matplotlib.axes.Axes.tick_params` using the ``rotation``
 keyword.
 
 ::
 
-    ax.xaxis.set_tick_params(which='both', rotation=90)
+    ax.tick_params(which='both', rotation=90)
 
 
 Ticklabels are turned off instead of being invisible
 ----------------------------------------------------
 
-Internally, :func:`~matplotlib.axis.Axis.set_tick_params` is now used to
-hide tick labels instead of setting the visibility on the tick label objects.
+Internally, the `Tick`'s :func:`~matplotlib.axis.Tick.label1On` attribute
+is now used to hide tick labels instead of setting the visibility on the tick
+label objects.
 This improves overall performance and fixes some issues.
-As a consequence, in case those labels ought to be shown, `set_tick_params`
-needs to be used, e.g. `ax.xaxis.set_tick_params(labelbottom=True)`.
+As a consequence, in case those labels ought to be shown,
+:func:`~matplotlib.axes.Axes.tick_params`
+needs to be used, e.g.
+
+::
+
+    ax.tick_params(labelbottom=True)
 
 
 Shading in 3D bar plots
diff --git a/lib/matplotlib/figure.py b/lib/matplotlib/figure.py
@@ -1268,11 +1268,11 @@ def subplots(self, nrows=1, ncols=1, sharex=False, sharey=False,
             labels of the bottom subplot are created. Similarly, when subplots
             have a shared y-axis along a row, only the y tick labels of the
             first column subplot are created. To later turn other subplots'
-            ticklabels on, use :meth:`~matplotlib.axis.Axis.set_tick_params`.
+            ticklabels on, use :meth:`~matplotlib.axes.Axes.tick_params`.
 
         squeeze : bool, optional, default: True
-            - If True, extra dimensions are squeezed out from the returned Axes
-              object:
+            - If True, extra dimensions are squeezed out from the returned
+              array of Axes:
 
                 - if only one subplot is constructed (nrows=ncols=1), the
                   resulting single Axes object is returned as a scalar.
diff --git a/lib/matplotlib/pyplot.py b/lib/matplotlib/pyplot.py
@@ -1015,11 +1015,11 @@ def subplots(nrows=1, ncols=1, sharex=False, sharey=False, squeeze=True,
         labels of the bottom subplot are created. Similarly, when subplots
         have a shared y-axis along a row, only the y tick labels of the first
         column subplot are created. To later turn other subplots' ticklabels
-        on, use :meth:`~matplotlib.axis.Axis.set_tick_params`.
+        on, use :meth:`~matplotlib.axes.Axes.tick_params`.
 
     squeeze : bool, optional, default: True
-        - If True, extra dimensions are squeezed out from the returned Axes
-          object:
+        - If True, extra dimensions are squeezed out from the returned
+          array of Axes:
 
             - if only one subplot is constructed (nrows=ncols=1), the
               resulting single Axes object is returned as a scalar.
