Updates README

Adds installation instructions and updates the examples to match
reality.  Also adds some text explanations to the examples because they
aren't immediately obvious.

**Note:** I did not add docs about the GPG stuff, because I don't know about
anything about it.