Add note to describe annotation behavior

zitorelova · zitorelova · commit a78aa0195c7b · 2021-01-20T19:56:57.000-08:00
diff --git a/lib/matplotlib/text.py b/lib/matplotlib/text.py
@@ -1675,7 +1675,9 @@ def transform(renderer) -> Transform
 
         arrowprops : dict, optional
             The properties used to draw a `.FancyArrowPatch` arrow between the
-            positions *xy* and *xytext*.
+            positions *xy* and *xytext*. Note that the edge of the arrow pointing
+            to *xytext* will be centered on the text itself and may not point
+            directly to the coordinates given in *xytext*.
 
             If *arrowprops* does not contain the key 'arrowstyle' the
             allowed keys are:
