Backport PR #14100: Improve docstring of axes_zoom_effect example.

timhoffm · MeeseeksDev[bot] · commit f47cd2a4d070 · 2019-04-30T10:13:02.000Z
diff --git a/examples/subplots_axes_and_figures/axes_zoom_effect.py b/examples/subplots_axes_and_figures/axes_zoom_effect.py
@@ -4,9 +4,9 @@
 ================
 
 """
+
 from matplotlib.transforms import (
     Bbox, TransformedBbox, blended_transform_factory)
-
 from mpl_toolkits.axes_grid1.inset_locator import (
     BboxPatch, BboxConnector, BboxConnectorPatch)
 
@@ -39,14 +39,19 @@ def connect_bbox(bbox1, bbox2,
 
 def zoom_effect01(ax1, ax2, xmin, xmax, **kwargs):
     """
-    ax1 : the main axes
-    ax1 : the zoomed axes
-    (xmin,xmax) : the limits of the colored area in both plot axes.
-
-    connect ax1 & ax2. The x-range of (xmin, xmax) in both axes will
-    be marked.  The keywords parameters will be used ti create
-    patches.
-
+    Connect *ax1* and *ax2*. The *xmin*-to-*xmax* range in both axes will
+    be marked.
+
+    Parameters
+    ----------
+    ax1
+        The main axes.
+    ax2
+        The zoomed axes.
+    xmin, xmax
+        The limits of the colored area in both plot axes.
+    **kwargs
+        Arguments passed to the patch constructor.
     """
 
     trans1 = blended_transform_factory(ax1.transData, ax1.transAxes)
