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