Backport PR #29260: DOC: Better explanation of rcParams "patch.edgecolor" and "patch.force_edgecolor"

QuLogic · meeseeksmachine · commit b575af123dea · 2024-12-12T00:54:29.000Z
diff --git a/lib/matplotlib/mpl-data/matplotlibrc b/lib/matplotlib/mpl-data/matplotlibrc
@@ -148,8 +148,14 @@
 ## for more information on patch properties.
 #patch.linewidth:       1.0    # edge width in points.
 #patch.facecolor:       C0
-#patch.edgecolor:       black  # if forced, or patch is not filled
-#patch.force_edgecolor: False  # True to always use edgecolor
+#patch.edgecolor:       black  # By default, Patches and Collections do not draw edges.
+                               # This value is only used if facecolor is "none"
+                               # (an Artist without facecolor and edgecolor would be
+                               # invisible)  or if patch.force_edgecolor is True.
+#patch.force_edgecolor: False  # By default, Patches and Collections do not draw edges.
+                               # Set this to True to draw edges with patch.edgedcolor
+                               # as the default edgecolor.
+                               # This is mainly relevant for styles.
 #patch.antialiased:     True   # render patches in antialiased (no jaggies)
 
 
