Formatting, add some new notes wrt. gen.sh.
More formatting.
Merge pull request #23 from castrojo/master

Some README updates