On Wed, 5 Apr 2023 17:29:17 GMT, Jonathan Gibbons <j...@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