Talk:Javadoc

I've removed the reference to the @returns tag. It is not documented at [1] or [2] nor does it seem to be a valid tag on at least Apple's implementation of Java J2SE 5.0. However, the Windows Java implementation accepts it as a synonym to @return, and the Eclipse IDE hilights it as a valid tag. Additional information about @returns would be appreciated. Paulymer5 08:53, 16 April 2006 (UTC)

The "Running Javadoc in Windows" section seems entirely unnecessary. First, it violates WP:NOT#HOWTO. That aside, all the information could be obtained from the manual, especially considering that the installation directory and JDK version have been hardcoded in the example. More worrisome is that Java runs on many platforms and this example only covers 1, not even mentioning the others. I suggest that this section be removed or reworked to be more general. If there's no debate I may do so if I get the time. -- vsync 06:15, 8 August 2007 (UTC)[reply]

List of tags?

Any particular reason there's not a list of valid tags in this article, nor a link to one? It was a pain in the butt to find them here: http://java.sun.com/j2se/1.4.2/docs/tooldocs/windows/javadoc.html#javadoctags Much more clicking than should have been necessary, even if I weren't lazy =P. Like I'm too lazy to sign in at the moment... 129.21.39.95 03:56, 29 September 2007 (UTC)[reply]

Yes, because Wikipedia is not a Manual WP:NOT#GUIDE. If you are interested in the workings of Javadoc, perhaps you should consult either the official reference material (as you did) or a forum, channel, or site dedicated to the tool. As it stands, there is a link to the official documentation already. Paulymer5 21:23, 29 September 2007 (UTC)[reply]