How to write javadocs which make no sense 101