RFR: 8297437: javadoc cannot link to old docs (with old style anchors) [v2]

Hannes Wallnöfer hannesw at openjdk.org
Wed Jan 25 16:05:42 UTC 2023


On Wed, 25 Jan 2023 10:42:30 GMT, Roman Marchenko <rmarchenko at openjdk.org> wrote:

>> As it discussed on the mail list, checking presence of "element-list" or "package-list" is good enough approach to determine which type of anchors is used in external docs. The fix is for docs generated by 'supported' platforms only, i.e. 8, 11, ...
>> 
>> This fix extends `Extern.Item` with `useOldFormId` boolean flag to indicate a type of anchor. The boolean flag is set accordingly when reading a list of elements from either "element-list" or "package-list". 
>> 
>> Name transformation is performed in `Extern.getExternalLink()` by `getOldFormHtmlName()` call when creating `DocLink` instance.
>> 
>> Type of anchors used by platform docs are hard-coded in `isOldFormPlatformDocs()` (similar to `getPlatformElementList()`), since it's not supposed to rebuild platform docs on docs.oracle.com.
>
> Roman Marchenko has updated the pull request incrementally with one additional commit since the last revision:
> 
>   Copyright changed, added the bug ID to TestLinkPlatform.

I can sponsor this PR.

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

PR: https://git.openjdk.org/jdk/pull/12066


More information about the javadoc-dev mailing list