Improve description for some methods.

Coneko proposed great changes to the original document, so here they are.