On Wed, 4 Feb 2026 11:53:53 GMT, Anton Artemov <[email protected]> wrote:
>> src/java.base/share/classes/java/lang/FdLibm.java line 3514: >> >>> 3512: /** >>> 3513: * Return the Inverse Hyperbolic Sine of x >>> 3514: * >> >> This is inside a javadoc comment. >> If you want structuring into paragraphs, you need to add `<p>` at the >> beginning of new paragraphs, except the 1st. >> >> Alternatively, you could convert to a block comment. In a block comment you >> can use `<` rather than `<`, but then all the `&...;` HTML named entities >> make no much sense. > > I do not see any other method in FdLibm.java having this type paragraph > formatting in place. I will keep it as it is. True, but IMO that doesn't mean new code can't do better 😉. The rendered javadoc comment looks ugly in the IDE. ------------- PR Review Comment: https://git.openjdk.org/jdk/pull/29273#discussion_r2763999862
