fixups in documentation.

+ bug fix wrt to scaling time multiple times within a timeline.