updating java docs, proper method names