JavaDocs and  Java 7 warning
Rewrite some of the README