describe shared axes behavior with units

l-johnston · l-johnston · commit 26ae2dccbe43 · 2020-09-08T07:28:07.000-05:00
diff --git a/lib/matplotlib/gridspec.py b/lib/matplotlib/gridspec.py
@@ -286,6 +286,10 @@ def subplots(self, *, sharex=False, sharey=False, squeeze=True,
             first column subplot are created. To later turn other subplots'
             ticklabels on, use `~matplotlib.axes.Axes.tick_params`.
 
+            When subplots have a shared axis that has units, calling
+            `~matplotlib.axis.Axis.set_units` will update each axis with the
+            new units.
+
         squeeze : bool, optional, default: True
             - If True, extra dimensions are squeezed out from the returned
               array of Axes:
