RFR: 4511638: Double.toString(double) sometimes produces incorrect results [v14]

[Alan Bateman]

On Wed, 1 Jun 2022 08:56:38 GMT, Raffaello Giulietti <duke at openjdk.java.net> wrote:

>> src/java.base/share/classes/jdk/internal/math/MathUtils.java line 38:
>> 
>>> 36:      *
>>> 37:      *     Giulietti, "The Schubfach way to render doubles",
>>> 38:      *     https://drive.google.com/file/d/1gp5xv4CAa78SVgCeWfGqqI4FfYYYuNFb
>> 
>> Even though not public, should the reference use the `<cite/>` tag and perhaps be in a `@see` annotation?
>> 
>> @see <a href=“https://drive.google.com/file/d/1gp5xv4CAa78SVgCeWfGqqI4FfYYYuNFb”>
>>      <cite>The Schubfach way to render doubles</cite></a>
>
> These references are inside a normal multi-line comment, so I'm not sure that Javadoc or html tags or have a well-defined semantics there.

I'm not sure about linking to a document on Google Drive, even from JDK internal classes. Is the paper uploaded to anywhere else that could be linked to instead?

-------------

PR: https://git.openjdk.java.net/jdk/pull/3402