Rewrites documentation for rotate3_inertia and renames to relevant funct...

...ions.

The rotate3_inertia's documentation defined the rotation matrix as v_a = R *
v_b but what it actually returned seemed to be from the definition v_b = R *
v_a. I updated the documentation to reflect this and altered the
Human.inertia_transformed to return what it's documentation says it returns.
Finally I renamed rotate3_inertia to rotate_inertia and switched the order of
the arguments and I renamed Human.inertia_transformed to
Human.transform_inertia so that the name is a verb indicating what the method
does rather than what it returns. Both of these have deprecation warnings so
the old names can be used until Yeadon 2.0. I also moved the deprecation
warning to it's own module so that it can be more easily used in all the
modules with no chance of circular dependencies.

Tasks

- [x] Make sure rotate3_inertia is being used properly in the Yeadon code (see PR #80).
- [x] Update internal code to new function names.
- [x] Change `transform_inertia` back to `inertia_transformed`.
- [x] Change the argument order of `inertia_transformed` back to original order (done in PR #80).