Can we amend the documentation, or request it. I occasionally come across things which need some clarity, e.g.
angle(x1, y1, x2, y2) Calculate angle between two points
doesn't actually specify which way round it is, is it the angle from x1 to x2 or x2 to x1 ?