Talk:Javadoc

From Wikipedia, the free encyclopedia
Jump to: navigation, search
WikiProject Java (Rated Start-class, High-importance)
WikiProject icon This article is within the scope of WikiProject Java, a collaborative effort to improve the coverage of Java on Wikipedia. If you would like to participate, please visit the project page, where you can join the discussion and see a list of open tasks.
Start-Class article Start  This article has been rated as Start-Class on the project's quality scale.
 High  This article has been rated as High-importance on the project's importance scale.
 

-- no official sun javadoc has search, unless embedded in other 3rd party web pages. Criticism should stay, but I agree it needs to be revamped. —Preceding unsigned comment added by 81.196.150.164 (talk) 09:45, 12 May 2009 (UTC)

to critism: doxygen can generate javadoc html page with search function. I doesnt test, just know from colleague. Please test it someone.

Criticism is an opinion with no supporting references. I think it should be removed. —Preceding unsigned comment added by 194.80.32.8 (talk) 13:30, 27 February 2009 (UTC)

@194.80.32.8 - The criticism section in its current state is pointless indeed, so I'm removing it. --Duplode (talk) 03:49, 27 March 2010 (UTC)

Reference in introduction[edit]

I removed two links in the introduction. One to Programmer's File Editors which did not seem specific to Javadoc and the other to http://www.slickedit.com, where the page did not provide any relevant information about what it claimed to reference. —Preceding unsigned comment added by Wikiuser1239 (talkcontribs) 22:10, 7 February 2009 (UTC)


A bit method-centric[edit]

>>Structure of a Javadoc comment ... >>The first paragraph is a description of the method documented.

The article launches in as if methods are the only thing worth Javadoc-ing - what about Javadoc for classes, packages and the like? Renny Barrett (talk) 23:31, 18 September 2010 (UTC)

Mistake in example?[edit]

I think that there is a mistake in example. Current version:

* @version     1.6                 (the version of the package this class was first added to)                   
* @since       2010-03-31          (a date or the version number of this program)

Correct version (?):

* @version     1.6                 (a date or the version number of this program)                   
* @since       2010-03-31          (the version of the package this class was first added to)  — Preceding unsigned comment added by 196.3.50.254 (talk) 12:54, 8 May 2012 (UTC) 

@jls Comments[edit]

There is one kind of Javadoc comment missing here, the @jls tag, which specifies a link to the Java Language Specification (used in Java API javadoc). Gparyani (talk) 18:51, 13 December 2012 (UTC)

"Javadoc was one of the first documentation generators"[edit]

So when did Knuth invent Literate Programming again? — Preceding unsigned comment added by 202.162.181.145 (talk) 00:54, 25 October 2013 (UTC)