Well, I was (am) too lazy to write a documentation (and nobody asked by that time ).
Raptor's animation system is fast and efficient but if you need to use more complex animations (non-linear), rmotion may help you (ask me, it's always better with a use case).