[ZOOKEEPER-1386] avoid flaky URL redirection in "ant javadoc" : replace "http://java.sun.com/javase/6/docs/api/" with "http://download.oracle.com/javase/6/docs/api/"

• Type: Bug
• Status: Resolved
• Priority: Minor
• Resolution: Fixed
• Fix Version/s: 3.3.5, 3.4.4, 3.5.0
• Component/s: documentation
• Assignee: Eugene Joseph Koontz
• Reporter: Eugene Joseph Koontz
• Created: 03/Feb/12 19:14
• Updated: 28/Feb/12 00:23
• Resolved: 27/Feb/12 01:01

Description

It seems that the current javadoc.link.java value, http://java.sun.com/javase/6/docs/api/, redirects (via HTTP 301) to http://download.oracle.com/javase/6/docs/api/. This redirect does not always work apparently, causing the URL fetch to fail. This causes an additional javadoc warning:

javadoc: warning - Error fetching URL: http://java.sun.com/javase/6/docs/api/package-list

which can in turn cause Jenkins to give a -1 to an otherwise OK build (see e.g. https://issues.apache.org/jira/browse/ZOOKEEPER-1373?focusedCommentId=13199456&page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel#comment-13199456).

Issue Links

• is related to: HADOOP-8019 Oracle no longer supports old javadoc URL, so we get a lot more javadoc warnings