minor fix in documentation
add function description for calc_rotation()