update description in gem and rdoc bits
Flesh out README.
notice about pem files
doc coverage