This week's book giveaway is in the OO, Patterns, UML and Refactoring forum. We're giving away four copies of Refactoring for Software Design Smells: Managing Technical Debt and have Girish Suryanarayana, Ganesh Samarthyam & Tushar Sharma on-line! See this thread for details.
Just beginning to experiment with Javadoc. It does not appear that the @author tag is recognized within Javadoc, or at least the version that comes with the download of j2sdk1.4.1_02. I've tried my own comments using that tag, as well as copying Paul Wheaton's source code for AWT class from Javaranch. In neither case did the @author tag produce an Author comment in the HTML. The other tags, such as @param and @return are recognized and produce the appropriate comments. Is this a flaw in Javadoc, or am I doing something wrong?
By default, javadoc doesn't do anything with @author tags unless you use the -author switch on the command line. Try typing "javadoc" with no arguments to see the (long) list of possible arguments to javadoc.