This article is rated Start-class on Wikipedia's content assessment scale. It is of interest to the following WikiProjects: | |||||||||||
|
Untitled
edit-- 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
editI 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 (talk • contribs) 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)
- Agreed, that was my first thought on reading through the page. 2601:843:C200:C8:B70A:9CA2:E6:7BDD (talk) 14:34, 8 June 2021 (UTC)
Mistake in example?
editI 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
editThere 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"
editSo when did Knuth invent Literate Programming again? — Preceding unsigned comment added by 202.162.181.145 (talk) 00:54, 25 October 2013 (UTC)
Oracle as the company that created it / DONE
editEven 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 2.26.31.181 (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
Merge proposal
edit- The following discussion is closed. Please do not modify it. Subsequent comments should be made in a new section. A summary of the conclusions reached follows.
- The result of this discussion was merge . LucyPoulton (talk) 14:58, 18 August 2022 (UTC)
I propose that we merge Doclet into Javadoc - doclets are a part of Javadoc and have no significance outside of that. LucyPoulton (talk) 08:27, 3 August 2022 (UTC)
- Support. Doclets are a facet of the JavaDoc API. SWinxy (talk) 22:47, 16 August 2022 (UTC)
Start a discussion about improving the Javadoc page
Talk pages are where people discuss how to make content on Wikipedia the best that it can be. You can use this page to start a discussion with others about how to improve the "Javadoc" page.