Merge pull request #26318 from meeseeksmachine/auto-backport-of-pr-26317-on-v3.7.x

ksunden · web-flow · commit b94988676dea · 2023-07-15T16:21:55.000-05:00
Backport PR #26317 on branch v3.7.x (update the doc string for fancyarrowpatch to link to annotate)
diff --git a/lib/matplotlib/patches.py b/lib/matplotlib/patches.py
@@ -4029,7 +4029,11 @@ def get_bbox(self):
 
 class FancyArrowPatch(Patch):
     """
-    A fancy arrow patch. It draws an arrow using the `ArrowStyle`.
+    A fancy arrow patch.
+
+    It draws an arrow using the `ArrowStyle`. It is primarily used by the
+    `~.axes.Axes.annotate` method.  For most purposes, use the annotate method for
+    drawing arrows.
 
     The head and tail positions are fixed at the specified start and end points
     of the arrow, but the size and shape (in display coordinates) of the arrow
