Use rustdoc compatible comments.

If you use `///` for comments you can generate pretty documentation with `cargo doc` :smile:

I also nailed some trailing whitespace, hope you don't mind.