[OpenJDK 2D-Dev]  RFR JDK-8189702: Broken links in javadoc for Adobe TIFF related documents
Jayathirth D V
jayathirth.d.v at oracle.com
Tue Oct 31 05:56:08 UTC 2017
Good day to you.
I tried finding references pointing to TIFF spec, TIFF Page maker notes & TIFF Photoshop notes but I was not able to find any links from Adobe which can replace presently available links.
For TIFF Page Maker & TIFF Photoshop notes the only available links are from Wayback archive and for TIFF spec we have links from ITU(https://www.itu.int/itudoc/itu-t/com16/tiff-fx/docs/tiff6.pdf ) and AlternaTIFF(http://www.alternatiff.com/resources/TIFFPM6.pdf ) among them I feel ITU one is more relevant to keep in Javadoc.
If Wayback links are not proper then we can actually remove links for TIFF Page Maker and TIFF Photoshop from Javadoc. If we can use ITU link for TIFF spec we can replace it otherwise we can remove reference for TIFF spec also.
Please let me know your inputs.
From: Brian Burkhalter
Sent: Tuesday, October 31, 2017 5:45 AM
To: Jayathirth D V
Subject: Re: [OpenJDK 2D-Dev]  RFR JDK-8189702: Broken links in javadoc for Adobe TIFF related documents
My question is whether we really want to link to the Wayback Machine or find other, legitimate sources? This of course might mean that the original documents cannot be linked.
On Oct 30, 2017, at 1:44 AM, Jayathirth D V <HYPERLINK "mailto:jayathirth.d.v at oracle.com"jayathirth.d.v at oracle.com> wrote:
Please review the following fix in JDK10 :
Bug : https://bugs.openjdk.java.net/browse/JDK-8189702
Webrev : http://cr.openjdk.java.net/~jdv/8189702/webrev.00/
Issue : Links present in Javadoc for TIFF specification, TIFF Page Maker document & TIFF Photoshop document are broken.
Solution : Replaced broken links with available archived links. Character length for these links are shooting more than 80 char length, breaking the link into multiple lines will not work in all the browsers. Alternate solution for this is to remove references for TIFF Page Maker and TIFF Photoshop from Javadoc and use a shorter ITU link (https://www.itu.int/itudoc/itu-t/com16/tiff-fx/docs/tiff6.pdf ) only for TIFF spec.
-------------- next part --------------
An HTML attachment was scrubbed...
More information about the 2d-dev