updated obsolete language regarding differences between Java and Scala APIs
corrected bad links in README