Update javadocs so as we explain better the meaning of a dollar in the key part of animation parameters. Fixes issue 168 (google). Fixes issue #5 (github).