Fix documentation after reading via server.

Examining the existing documentation over the standard Go documentation
server revealed some serious formatting flaws.  Everything should be
readable now.
Merge pull request #3 from prometheus/usability/sundry

Fix documentation after reading via server.