added more details within java-doc