RFR: 8372353: API to compute the byte length of a String encoded in a given Charset [v2]

[Liam Miller-Cushon]

On Thu, 15 Jan 2026 13:28:23 GMT, Roger Riggs <rriggs at openjdk.org> 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