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

[Raffaello Giulietti]

On Tue, 31 May 2022 21:35:08 GMT, Brian Burkhalter <bpb at openjdk.org> wrote:

>> Raffaello Giulietti has updated the pull request incrementally with one additional commit since the last revision:
>> 
>>   4511638: Double.toString(double) sometimes produces incorrect results
>
> 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.

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

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