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