Comment Re:Examples (Score 3, Informative) 299
JavaDocs are documentation that you include with java classes. They fill the same niche as sections 2 and 3 of the UNIX man pages.
If you've ever used perl POD documentation, they work kind of like that on a conceptual level.
This is all documentation aimed at programmers, of course, not application or system documentation. If you want to provide documentation for a java application, you generally don't do it with JavaDoc.