DOC: Document default cap styles

StefRe · StefRe · commit aa37c325b84c · 2022-01-11T09:51:11.000+01:00
- remove '(default)' from cap style demo as this is only true for Line2D
  and the default rcParameters
- document default cap styles for Line2D and Patch in their cap style
  setters
- document default cap style for GraphicsContextBase in the same way as
  it's already done for joinstyle
diff --git a/lib/matplotlib/_enums.py b/lib/matplotlib/_enums.py
@@ -128,6 +128,9 @@ class CapStyle(str, _AutoStringNameEnum):
     For a visual impression of each *CapStyle*, `view these docs online
     <CapStyle>` or run `CapStyle.demo`.
 
+    By default, `~.backend_bases.GraphicsContextBase` draws a stroked line as
+    squared off at its endpoints.
+
     **Supported values:**
 
     .. rst-class:: value-list
@@ -168,7 +171,6 @@ def demo():
             ax.plot(xx, yy, lw=12, color='tab:blue', solid_capstyle=style)
             ax.plot(xx, yy, lw=1, color='black')
             ax.plot(xx, yy, 'o', color='tab:red', markersize=3)
-        ax.text(2.25, 0.55, '(default)', ha='center')
 
         ax.set_ylim(-.5, 1.5)
         ax.set_axis_off()
diff --git a/lib/matplotlib/lines.py b/lib/matplotlib/lines.py
@@ -1329,6 +1329,7 @@ def get_solid_joinstyle(self):
     def set_dash_capstyle(self, s):
         """
         How to draw the end caps if the line is `~Line2D.is_dashed`.
+        The default capstyle is :rc:`lines.dash_capstyle`.
 
         Parameters
         ----------
@@ -1343,6 +1344,7 @@ def set_dash_capstyle(self, s):
     def set_solid_capstyle(self, s):
         """
         How to draw the end caps if the line is solid (not `~Line2D.is_dashed`)
+        The default capstyle is :rc:`lines.solid_capstyle`.
 
         Parameters
         ----------
diff --git a/lib/matplotlib/patches.py b/lib/matplotlib/patches.py
@@ -473,6 +473,8 @@ def get_fill(self):
     def set_capstyle(self, s):
         """
         Set the `.CapStyle`.
+        The default capstyle is 'round' for `.FancyArrowPatch` and 'butt' for
+        all other patches.
 
         Parameters
         ----------
