Enhance java doc

Deal! :)

Would you mind updating the other files?