On Wed, 1 Jun 2022 08:56:38 GMT, Raffaello Giulietti <d...@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