Rework documentation.
Added a comment to undocumented function.

Although the name is obvious, I like comments.
Merge pull request #8 from antoinealb/master

Rework documentation