Documentation cleanup

Cleaned up the README to be in line with Go 1 installation conventions, added the examples to a test file so they will be tested with "go test" and show up in godoc.

This also fixes issue #1.