javadoc.clj contains javadoc base urls for the jdk and several popular open source libraries. Most of these urls are broken.
For example, create a project with the following dependencies:
And then try the following javadoc checks:
Fixes:
Update jdk javadoc urls and explicitly include 1.6, 1.7, and 1.8, falling back to 1.8 (most common in use right now)
Update commons-codec javadoc url
Update commons-io javadoc url
Update commons-lang javadoc url (not that commons-lang last release was 2.6)
Add commons-lang3 javadoc url (the 3+ version of commons-lang changed the base package name)
Add guava javadoc url (another very common Java library)
Patch: clj-1398.patch
Comment made by: elindsey
> It is the policy of the Clojure team only to incorporate patches submitted by people who have signed and submitted a Clojure CA. Were you interested in doing that?
Yup! I mailed off the CA to Rich on Wednesday when this was filed; should be arriving shortly.
Comment made by: elindsey
Just to note - Clojure CA went through and I'm listed on the contributors page now.
I squashed the patches and made some minor modifications in the jdk urls. Patch attribution retained.
Thanks Bozhidar - I expect this will get updated for Clojure 1.9.
On the note in the change in method urls, the clojure.java.javadoc/javadoc function only builds urls to classes, not to methods, so I don't think that note has any impact on the patch.