Reply to comment

How about comments specifically meant for javadoc?

In general, I agree that code should be self-documenting.

However, some of these examples could be destined for javadoc.

Admittedly, these examples do not strictly follow javadoc conventions. However, a bit of explanatory candy for the javadoc to munch on is better than nothing, especially if I am not necessarily looking at the code at the moment but some automatically generated documentation.

Reply

CAPTCHA
This question is for testing whether you are a human visitor and to prevent automated spam submissions.