Updated README and in the process discovered lots of bugs which were then fixed