DOC: clarify that savefig(..., transparent=False) has no effect

tacaswell · tacaswell · commit 6c2d146a2b63 · 2021-05-13T19:06:24.000-04:00
re-closes #14339
diff --git a/lib/matplotlib/figure.py b/lib/matplotlib/figure.py
@@ -2890,8 +2890,12 @@ def savefig(self, fname, *, transparent=None, **kwargs):
 
         transparent : bool
             If *True*, the Axes patches will all be transparent; the
-            figure patch will also be transparent unless facecolor
+            Figure patch will also be transparent unless facecolor
             and/or edgecolor are specified via kwargs.
+
+            If *False* has no effect and leaves the color of the Axes and
+            Figure patches as they are.
+
             This is useful, for example, for displaying
             a plot on top of a colored background on a web page.  The
             transparency of these patches will be restored to their
