RFR: 8375285: Port fdlibm asinh to Java [v7]
Raffaello Giulietti
rgiulietti at openjdk.org
Wed Feb 4 13:37:03 UTC 2026
On Wed, 4 Feb 2026 11:53:53 GMT, Anton Artemov <aartemov at openjdk.org> 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
More information about the core-libs-dev
mailing list