README: mention where usage information is and so on

I also tuned up a bit of the manpage-style documentation so it reads
better when you're not actually reading main.go directly, eg you're
reading it through godoc.