improved java docs