RFR: JDK-8305593: Add @spec tags in java.desktop

Phil Race prr at openjdk.org
Fri Apr 7 01:39:44 UTC 2023


On Wed, 5 Apr 2023 17:29:17 GMT, Jonathan Gibbons <jjg at openjdk.org> wrote:

> Please review a docs-only change to add `@spec` tags into `java.desktop` public API files

src/java.desktop/share/classes/java/awt/Desktop.java line 591:

> 589:      * subprocess
> 590:      * @spec https://www.rfc-editor.org/info/rfc2368
> 591:      *      RFC 2368: The mailto URL scheme

The javadoc above references ietf.org. This tag references rfc-editor.org. It seems odd to use two different URLs
in the same method specification for the same RFC. I would have thought the ietf one better to use .. although it should be updated to https

src/java.desktop/share/classes/javax/imageio/plugins/tiff/BaselineTIFFTagSet.java line 227:

> 225:      * @spec https://www.rfc-editor.org/info/rfc1951
> 226:      *      RFC 1951: DEFLATE Compressed Data Format Specification version 1.3
> 227:      */

OK. So why are you preferring this rfc-editor.org site ?
Seems we should get that cleared up before I look further

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

PR Review Comment: https://git.openjdk.org/jdk/pull/13360#discussion_r1160372976
PR Review Comment: https://git.openjdk.org/jdk/pull/13360#discussion_r1160373170



More information about the client-libs-dev mailing list