Include "since" info in generated Javadoc for new and deprecated APIs

[sbrannen]

Overview

Recent versions of the javadoc command support -since and -since-label options which allow @since and @Deprecated(since=...) information to be included in the generated Javadoc HTML.

Examples for JDK 24

• New APIs
• Deprecated APIs

Examples for Spring Framework.

Screenshots taken from local build.

[sbrannen]

To try this out for yourself in a local build, use this branch.

main...sbrannen:spring-framework:issues/gh-35906-javadoc-since-new-and-deprecated-api-info

[sbrannen]

FWIW, we already have a Deprecated APIs page included in the Javadoc, but you cannot filter by "since" by default.

[sdeleuze]

The 6.2 part is confusing, if we enable this feature we should move @since tags from @since 6.2 to @since 6.2.0 (and same for other majors).

I am also puzzled by the too many releases displayed, the UI looks pretty bad with that amount of versions. If wildcards are not supported, maybe we should focus on the latest major.

[sbrannen]

The 6.2 part is confusing, if we enable this feature we should move @since tags from @since 6.2 to @since 6.2.0 (and same for other majors).

That's certainly worth considering.

I am also puzzled by the too many releases displayed, the UI looks pretty bad with that amount of versions. If wildcards are not supported, maybe we should focus on the latest major.

I merely selected all of those manually as an experiment and to show how the feature works.

Let's discuss within the team which explicit versions we want to include and what wording we'd like to use for the "since label".