Make the public documentation more Go Like.

Start all methods docs with the name of the method and make
it more readable.
Merge pull request #26 from miekg/doc

Make the public documentation more Go Like.