revising java docs