From Wikipedia, the free encyclopedia
Jump to navigation Jump to search
WikiProject Java (Rated Start-class, High-importance)
WikiProject iconThis 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 (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 (talk) 13:30, 27 February 2009 (UTC)

@ - 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, 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 (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 (talk) 00:54, 25 October 2013 (UTC)

Oracle as the company that created it / DONE[edit]

Even though they were bought out, Sun Microsystems should be credited directly with maybe a mention of them being bought out. I'd change it myself, but I can't be arsed getting into an edit war with some wiki elitist. So I request you to please apply my change, dear sir or madam. - Gav 19:37 BST - 26/06/2015 — Preceding unsigned comment added by (talk) 18:40, 26 June 2015 (UTC)

Done, now credited: "created by Sun Microsystems for the Java language (now owned by Oracle Corporation)". --Jari Aalto, 2015-09-15 10:26 UTC