preliminary gem support

It actually works but some more work needs to be done
updated install instructions for gem
expanded install instructions
rst format corrections
better option for settings.yml
Merge pull request #2 from renich/gem

to_gem