New README.md and comment fixes

This readme is accurate and hopefully a bit more clear. Also I removed some Unicode characters in the comments of a couple of source files, which were preventing Javadoc from running. (I wanted to put these two things in separate pull requests but I don't know how short of making a separate branch)