java docs fixes and 1 comment