Update docs.

lkjell · lkjell · commit e6eaf131337d · 2018-03-09T11:39:28.000+01:00
diff --git a/doc/users/next_whats_new/2017-12-05_share_unshare_axes_after_creation.rst b/doc/users/next_whats_new/2017-12-05_share_unshare_axes_after_creation.rst
@@ -1,8 +1,10 @@
 Share and unshare `axes` after creation
 ---------------------------------------
 
-`~.Axes` have `~.Axes.unshare_x_axes`, `~.Axes.unshare_y_axes`, `~.Axes.unshare_z_axes` and `~.Axes.unshare_axes` methods to unshare axes.
-Similiar there are `~.Axes.share_x_axes`, `~.Axes.share_y_axes`, `~.Axes.share_z_axes` and `~.Axes.share_axes` methods to share axes.
+`~.Axes` have `~.Axes.unshare_x_axes`, `~.Axes.unshare_y_axes`,
+`~.Axes.unshare_z_axes` and `~.Axes.unshare_axes` methods to unshare axes.
+Similiar there are `~.Axes.share_x_axes`, `~.Axes.share_y_axes`,
+`~.Axes.share_z_axes` and `~.Axes.share_axes` methods to share axes.
 
 Unshare an axis will decouple the viewlimits for further changes.
 Share an axis will couple the viewlimits.
diff --git a/lib/matplotlib/axes/_base.py b/lib/matplotlib/axes/_base.py
@@ -4294,7 +4294,9 @@ def unshare_x_axes(self, axes=None):
         Parameters
         ----------
         axes: Axes
-            Axes to unshare, if related. None will unshare itself.
+            Axes to unshare, if related.
+            None will unshare itself from all shares.
+            `self` will inverse unshare.
         """
         self._unshare_axes(axes, "x")
 
@@ -4305,7 +4307,9 @@ def unshare_y_axes(self, axes=None):
         Parameters
         ----------
         axes: Axes
-            Axes to unshare, if related. None will unshare itself.
+            Axes to unshare, if related.
+            None will unshare itself.
+            `self` will inverse unshare.
         """
         self._unshare_axes(axes, "y")
 
@@ -4316,7 +4320,9 @@ def unshare_axes(self, axes=None):
         Parameters
         ----------
         axes: Axes
-            Axes to unshare, if related. None will unshare itself.
+            Axes to unshare, if related.
+            None will unshare itself.
+            `self` will inverse unshare.
         """
         self.unshare_x_axes(axes)
         self.unshare_y_axes(axes)
@@ -4373,6 +4379,10 @@ def share_x_axes(self, axes, symmetric=True, transitive=True):
         ----------
         axes: Axes
             Axes to share.
+        symmetric: Bool
+            mutually share.
+        transitive: Bool
+            extent share to what axes shares.
         """
         self._share_axes(axes, 'x', symmetric, transitive)
 
@@ -4384,6 +4394,10 @@ def share_y_axes(self, axes, symmetric=True, transitive=True):
         ----------
         axes: Axes
             Axes to share.
+        symmetric: Bool
+            mutually share.
+        transitive: Bool
+            extent share to what axes shares.
         """
         self._share_axes(axes, 'y', symmetric, transitive)
 
@@ -4395,6 +4409,10 @@ def share_axes(self, axes, symmetric=True, transitive=True):
         ----------
         axes: Axes
             Axes to share.
+        symmetric: Bool
+            mutually share.
+        transitive: Bool
+            extent share to what axes shares.
         """
         self.share_x_axes(axes, symmetric, transitive)
         self.share_y_axes(axes, symmetric, transitive)
