RFR: 8325088: Overloads that differ in type parameters may be lost

[Jonathan Gibbons]

On Thu, 28 Mar 2024 12:54:10 GMT, Pavel Rappo <prappo at openjdk.org> wrote:

> While I've been working with javadoc for the last five years, somehow I've never had to deal with composability functionality provided by `link` and `linkoffline`. These options have been there since at least 1998: the earliest bug I found to mention them is https://bugs.openjdk.org/browse/JDK-4065454. Wow.
> 
> Back to the compatibility problem at hand. So we want to be able to link from the new output to the old output. Linking from the old output to the new output is out of the question, I suppose. After examining `Extern` briefly, I agree with Jon, in that the problem is not about transforming one string into another, but about mapping an element to a string.
> 
> I'll see what I can minimally do to support that.

Some of us are in the privileged position of being at the bottom of the software stack, and so we rarely if ever need to create documentation to other libraries.  That being said, I notice that is an issue for some users, so much so that it was an external contribution to address the previous instance of this kind of problem.

> Linking from the old output to the new output is out of the question, I suppose. 

Yes.

-------------

PR Comment: https://git.openjdk.org/jdk/pull/18519#issuecomment-2025702997