Name: dk30142 Date: 11/07/2001

The Javadoc spec for java.lang.Thread contains several links to
the threadPrimitiveDeprecation.html file at
j2se/1.4/docs/guide/misc/threadPrimitive.html.
An example of such a link is the one in the spec for the resume method:

http://java.sun.com/j2se/1.4/docs/api/java/lang/Thread.html#resume()

However, these links are broken in 1.4, though they aren't broken in
the 1.3.1 spec. In both 1.4 and 1.3.1, the HTML in the Javadoc comment
looks like this:

<a href="{@docRoot}/../guide/misc/threadPrimitiveDeprecation.html">Why
are Thread.stop, Thread.suspend and Thread.resume Deprecated?</a>.

In 1.3 the output looks like:
<a href="../../../guide/misc/threadPrimitiveDeprecation.html">Why
are Thread.stop, Thread.suspend and Thread.resume Deprecated?</a>.

But in 1.4 the output looks like:

<A href="../..//../guide/misc/threadPrimitiveDeprecation.html">Why
are Thread.stop, Thread.suspend and Thread.resume Deprecated?</A>.

I'm wondering if the fact that the same tag produces broken links in
1.4 but not in 1.3.1 means that there's a bug in the 1.4 Javadoc? Or
can you see some other reason that's causing the broken links?


======================================================================