Clarify the documentation of al_calculate_arc.

In the process I changed the name of one of the arguments, but the function
behavior remains the same. Hopefully the examples make clear what the prose
does not.