[OpenJDK 2D-Dev] [10] RFR JDK-8189702: Broken links in javadoc for Adobe TIFF related documents

[Jayathirth D V]

Hi Brian,

 

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.

 

Thanks,

Jay

 

From: Brian Burkhalter 
Sent: Tuesday, October 31, 2017 5:45 AM
To: Jayathirth D V
Cc: 2d-dev
Subject: Re: [OpenJDK 2D-Dev] [10] RFR JDK-8189702: Broken links in javadoc for Adobe TIFF related documents

 

Hi Jay,

 

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.

 

Thanks,

 

Brian

 

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...
URL: <http://mail.openjdk.java.net/pipermail/2d-dev/attachments/20171030/cf4a895b/attachment.html>