Mostly javadoc improvements. A few minor api tweaks as well.
Merge pull request #6 from jasnell/20140417-generalimprovements

Mostly javadoc improvements. A few minor api tweaks as well.