Update docstrings, small enhancements to Oskar's motion rework.

You can have a look at it, but I want to test is before so I need some more minutes.