Updates the README for readability, accuracy, etc.
Corresponding changes are made to the source.