cleaned warnings

[ghost]

I've cleaned some warnings the Go tools complain about:

• Url should be URL
• error messages should start with a lower case word and not end with punctuation
• exported funcs must have a doc comment

Please check if these changes are acceptable, especially the API changing rename to URL.

[SlyMarbo]

Thanks a lot for all the effort you've put in here, particularly with the documentation.