Make arrow docstring mention data transform

dmcdougall · dmcdougall · commit e8827864e9c6 · 2012-09-18T17:15:13.000+01:00
diff --git a/lib/matplotlib/axes.py b/lib/matplotlib/axes.py
@@ -6594,6 +6594,10 @@ def arrow(self, x, y, dx, dy, **kwargs):
         Draws arrow on specified axis from (*x*, *y*) to (*x* + *dx*,
         *y* + *dy*). Uses FancyArrow patch to construct the arrow.
 
+        The resulting arrow is affected by the axes aspect ratio and limits. This
+        may produce an arrow whose head is not square with its stem. To create
+        an arrow whose head is square with its stem, use :meth:`annotate`.
+
         Optional kwargs control the arrow construction and properties:
 
         %(FancyArrow)s
