README improvements

Separated out from #173
Yes - I expect a lot of complaints about the non-defined symbol else 8).