improve build instructions and examples in readme
format sources with gofmt
clean up error messages