adding some citations
updating javadocs