You are viewing a plain text version of this content. The canonical link for it is here.
Posted to jira@kafka.apache.org by "Josep Prat (Jira)" <ji...@apache.org> on 2021/05/25 11:36:00 UTC

[jira] [Commented] (KAFKA-12782) Javadocs search sends you to a non-existent URL

    [ https://issues.apache.org/jira/browse/KAFKA-12782?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17351001#comment-17351001 ] 

Josep Prat commented on KAFKA-12782:
------------------------------------

I can confirm this is bug with Java11 for API docs that do not use the modules system. It has been solved on JDK 12 and higher but not yet backported to JDK 11. See [https://bugs.openjdk.java.net/browse/JDK-8215291] for more details. Long story short, the search.js file appends the module name in the URL.

I ran the docs script manually specifying JDK 16 and the links on the search are generated correctly pointing to the right URL.

I will try to find a workaround that would make it work in the meantime. It is possible to disable the module system option for the API docs, however all links pointing to JDK APIs (i.e. String) won't work as they would need the submodule prefix.

> Javadocs search sends you to a non-existent URL
> -----------------------------------------------
>
>                 Key: KAFKA-12782
>                 URL: https://issues.apache.org/jira/browse/KAFKA-12782
>             Project: Kafka
>          Issue Type: Bug
>          Components: docs
>            Reporter: A. Sophie Blee-Goldman
>            Assignee: Josep Prat
>            Priority: Major
>
> I was looking up a class using the javadocs search functionality, and clicked on the link when TaskId came up, but it sent me to which [https://kafka.apache.org/28/javadoc/undefined/org/apache/kafka/streams/processor/TaskId.html] does not exist.
> I noticed the URL had an odd "undefined" term inserted before the package name, so I took that out and was able to find the [correct javadocs|https://kafka.apache.org/28/javadoc/org/apache/kafka/streams/processor/TaskId.html]. So the search seems to be broken due to this "undefined" term that's being injected somewhere, for some reason.



--
This message was sent by Atlassian Jira
(v8.3.4#803005)