New README.md

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 working.