[Doc]: Clarify default capstyle #21979
Description
Documentation Link
https://matplotlib.org/devdocs/api/_enums_api.html#matplotlib._enums.CapStyle
Problem
The demo states that the default capstyle is projecting, which is true for Line2D but not for PathPatch (where the default is 'butt').
import matplotlib.pyplot as plt
import matplotlib as mpl
fig,ax = plt.subplots(figsize=(2,1), layout='constrained')
xx = [0, 1]
yy = [0, 0]
ax.plot(xx, yy, lw=12, color='tab:blue')
ax.plot(xx, yy, lw=1, color='black')
ax.plot(xx, yy, 'o', color='tab:red', markersize=3)
ax.add_patch(mpl.patches.PathPatch(mpl.path.Path([[0, 0],[1, 0]]), lw=20, color='C1'))
ax.set_axis_off()
(see also https://stackoverflow.com/a/70381813/3944322)
Suggested improvement
Change (default) to (default for Line2D) in
matplotlib/lib/matplotlib/_enums.py
Line 171 in 98115e9
Matplotlib Version
3.5.0