fix javadoc & readme
adding readme and minor fixes