Talk:Javadoc#Merge proposal

-- 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)

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 (talk • contribs) 22:10, 7 February 2009 (UTC)

>>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)

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)

:That text seems to be gone now. Stevebroshar (talk) 11:15, 9 January 2025 (UTC)

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)

:And? ... Did you add it? Stevebroshar (talk) 11:12, 9 January 2025 (UTC)

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

:Your point? Are you saying that Knuth's book was the first document generator? But... a book is not a document generator. Are you implying that Javadoc was influenced by the book? More info please. Stevebroshar (talk) 11:11, 9 January 2025 (UTC)

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 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

{{Discussion top|result=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)

{{Discussion bottom}}

In the table of tags, some are enclosed in braces, like {@inheritDoc}. But some are not. What do the braces imply? If they mean something, that should be spelled out. If not they should be removed. Stevebroshar (talk) 11:18, 9 January 2025 (UTC)