Make documentation clearer.

minor, major pull request coming up.