On Thu, 15 Jan 2026 13:28:23 GMT, Roger Riggs <[email protected]> wrote:
>> Sorry I'm not sure I understand, can you clarify how that would work? >> >> The javadoc can't start with `@return`, it needs to be a non-tag sentence >> fragment (the build enables doclint to enforce this). > > fyi, New javadoc functionality in JDK 22 enabled @return as an inline tag. > (see the [Javadoc tag > specification](https://docs.oracle.com/en/java/javase/22/docs/specs/javadoc/doc-comment-spec.html)) > `As an inline tag, provides content for the first sentence of a method's main > description, and a "Returns" section, as if @return description were also > present. In the default English locale, the first sentence is Returns > description .` Thanks, that's good to know! I updated to use an `@return` inline tag. ------------- PR Review Comment: https://git.openjdk.org/jdk/pull/28454#discussion_r2694423894
