improve java docs