On Thu, 28 Mar 2024 12:54:10 GMT, Pavel Rappo <[email protected]> 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

Reply via email to