Update _secax_docstring

ZachDaChampion · ZachDaChampion · commit be0e8c021b00 · 2023-04-14T23:39:08.000-04:00
diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
@@ -550,7 +550,7 @@ def indicate_inset_zoom(self, inset_ax, **kwargs):
         return self.indicate_inset(rect, inset_ax, **kwargs)
 
     @_docstring.dedent_interpd
-    def secondary_xaxis(self, location, *, functions=None, transform=None, **kwargs):
+    def secondary_xaxis(self, location, *, transform=None, functions=None, **kwargs):
         """
         Add a second x-axis to this `~.axes.Axes`.
 
@@ -604,7 +604,7 @@ def invert(x):
         return secondary_ax
 
     @_docstring.dedent_interpd
-    def secondary_yaxis(self, location, *, functions=None, transform=None, **kwargs):
+    def secondary_yaxis(self, location, *, transform=None, functions=None, **kwargs):
         """
         Add a second y-axis to this `~.axes.Axes`.
 
diff --git a/lib/matplotlib/axes/_secondary_axes.py b/lib/matplotlib/axes/_secondary_axes.py
@@ -285,6 +285,12 @@ def set_color(self, color):
     parent axes to put the new axes, 0.0 being the bottom (or left)
     and 1.0 being the top (or right).
 
+transform : `.Transform`, optional
+    An optional transform that can be passed. *location* will be
+    placed relative to this transform (in the direction of the axis)
+    rather than the parent's axis. i.e. a secondary x-axis will
+    use the provided y transform and the x transform of the parent.
+
 functions : 2-tuple of func, or Transform with an inverse
 
     If a 2-tuple of functions, the user specifies the transform
