Add -since for javadoc

[arukiidou]

Deliverables

Add a new tab to the Javadoc.

example

how to

This fix was easy.

			addStringsOption("-since", ",").value = listOf(
				"6.1",
				"6.0",
				"5.14",
				"5.13",
				"5.12",
				"5.11",
				"5.10",
				"5.9",
				"5.8",
				"5.7",
				"5.6",
				"5.5",
				"5.4",
				"5.3",
				"5.2",
				"5.1",
				"5.0",
			)

[marcphilipp]

Thanks for bringing this to my attention! Personally, I was not aware this feature existed. If we decide to do it, I think we should populate the list from all r* Git tags (excluding milestones and RCs) and the current version (after removing the (.0)?-SNAPSHOT suffix).

[arukiidou]

r*Gitタグ

the -since option ignores git tags. It only considers the @since tag in Java comment.

example:

junit-framework/junit-jupiter-api/src/main/java/org/junit/jupiter/api/ClassOrderer.java

Line 117 in 7d483c7

* @since 6.0

Also, it seems that string wildcards were not allowed.

https://docs.oracle.com/en/java/javase/21/docs/specs/man/javadoc.html

--since release(,release)*
Generates documentation for APIs that were added or newly deprecated in the specified releases.

If the @since tag in the javadoc comment of an element in the documented source code matches a release passed as option argument, information about the element and the release it was added in is included in a "New API" page.

If the "Deprecated API" page is generated and the since element of the java.lang.Deprecated annotation of a documented element matches a release in the option arguments, information about the release the element was deprecated in is added to the "Deprecated API" page.

Releases are compared using case-sensitive string comparison.

[Vishalup29]

Hi @marcphilipp ,
I am a first time contributor and I'd like to take this up if the discussion has concluded.