Improved documentation.

This is for #205.
The previous documentation used the same k for two different quantities.
Improved documentation.

This is for #205.