Improve a few method description. Fixes #16 and #17.