matplotlib
diff --git a/‎lib/matplotlib/axes/_axes.py‎
Lines changed: 4 additions & 2 deletions b/‎lib/matplotlib/axes/_axes.py‎
Lines changed: 4 additions & 2 deletions
diff --git a/‎lib/matplotlib/patches.py‎
Lines changed: 6 additions & 0 deletions b/‎lib/matplotlib/patches.py‎
Lines changed: 6 additions & 0 deletions
@@ -452,8 +452,10 @@ def indicate_inset(self, bounds, inset_ax=None, *, transform=None,
         edgecolor : :mpltype:`color`, default: '0.5'
             Color of the rectangle and color of the connecting lines.
 
-        alpha : float, default: 0.5
-            Transparency of the rectangle and connector lines.
+        alpha : float or None, default: 0.5
+            Transparency of the rectangle and connector lines.  If not
+            ``None``, this overrides any alpha value included in the
+            *facecolor* and *edgecolor* parameters.
 
         zorder : float, default: 4.99
             Drawing order of the rectangle and connector lines.  The default,
 
@@ -380,6 +380,8 @@ def set_edgecolor(self, color):
         Parameters
         ----------
         color : :mpltype:`color` or None
+            Note that any alpha value included in this color will be ignored
+            unless the patch's alpha is set to ``None``.
         """
         self._original_edgecolor = color
         self._set_edgecolor(color)
@@ -398,6 +400,8 @@ def set_facecolor(self, color):
         Parameters
         ----------
         color : :mpltype:`color` or None
+            Note that any alpha value included in this color will be ignored
+            unless the patch's alpha is set to ``None``.
         """
         self._original_facecolor = color
         self._set_facecolor(color)
@@ -409,6 +413,8 @@ def set_color(self, c):
         Parameters
         ----------
         c : :mpltype:`color`
+            Note that any alpha value included in this color will be ignored
+            unless the patch's alpha is set to None.
 
         See Also
         --------