RFR 9: 8180082 : Broken javadoc links
jonathan.gibbons at oracle.com
Fri May 12 18:55:46 UTC 2017
I can strongly recommend using link checker tools.
For a long time, linklint has been the recommendation. However, linklint
cannot cope with "id" attribute on tags that are not <a> tags. That's
legal in HTML 5, but linklint is an old tool. There are newer tools out
there, for both online and offline use, but I haven't used them enough
to make a specific recommendation.
On 05/12/2017 01:26 AM, Magnus Ihse Bursie wrote:
> On 2017-05-10 23:05, Brian Burkhalter wrote:
>> Hi Roger,
>> Looks all right to me. I assume you will have already built the
>> actual docs and clicked through the updated links. Always a bit
>> painful …
> Did you test the actual links?
> I found one needing updating:
> In src/java.base/share/classes/java/io/ObjectStreamClass.java,
> class.html#4100 should be updated to
> Also, the link in src/java.base/share/classes/java/lang/String.java
> looks suspect. The text refers to Section 6.2 Stream Elements, but to
> get there the link should go to protocol.html#stream-elements. Instead
> it points to output.html, which is Section 2, Object Output Classes. I
> can't really tell which is correct, but my guess is that the text is
> correct and the link is not.
>> On May 10, 2017, at 11:22 AM, Roger Riggs <Roger.Riggs at Oracle.com>
>>> Please review corrections to broken javadoc links:
>>> - links to the serialization spec now in ./specs/serialization
>>> - links in java.lang to java/util/Spliterator
>>> - link in ModuleLayer to Classloader
>>> - Links using ../../../.. do not work well when they show up in some
>>> indexes; they should use @docRoot
More information about the core-libs-dev