Bug report

Bug summary

Axes.arrow/pyplot.arrow generates a FancyArrow, which has a rather awkward API (#12768); we typically suggest to use Axes.annotate/pyplot.annotate instead (even the docstring of arrow() does so!). We may want to keep FancyArrow around for backcompat (it is simple to convert calls to arrow() to ax.add_patch(FancyArrow(<the same args>))), but at least we should consider deprecating the toplevel arrow() function, which is just a bad trap for any new users.

Matplotlib version

• Operating system:
• Matplotlib version (import matplotlib; print(matplotlib.__version__)): 3.4.x
• Matplotlib backend (print(matplotlib.get_backend())):
• Python version:
• Jupyter version (if applicable):
• Other libraries: