All,

On 1/10/25 9:52 AM, Christopher Schultz wrote:
Maxim,

On 1/10/25 1:44 AM, Maxim Solodovnik wrote:
On Fri, 10 Jan 2025 at 13:40, Chuck Caldarale <n82...@gmail.com> wrote:


On Jan 9, 2025, at 23:09, Maxim Solodovnik <solomax...@gmail.com> wrote:

Hello All,

just have noticed Javadoc search is broken :(
my steps:
- open Javadoc main page at
https://tomcat.apache.org/tomcat-10.0-doc/api/index.html
- paste 'SSLHostConfig' into search box (at top-right)
- hit Enter key
Result: got 404 page at URL:
https://tomcat.apache.org/tomcat-10.0-doc/api/undefined/org/apache/ tomcat/util/net/SSLHostConfig.html


As well you should. Support for 10.0 expired quite some time ago, so the doc pages were removed. You should upgrade to 10.1 or higher and use the doc for that level.

Docs for 10.0 are still accessible:
https://tomcat.apache.org/tomcat-10.0-doc/index.html ...

Search at https://tomcat.apache.org/tomcat-10.1-doc/api/index.html
works as expected :)

Yeah, I kinda agree that Javadoc search for 10.0 should be working if we're going to have it up on the website.

The presence of the word "undefined" in that URL suggests to me that something isn't quite right with the javascript powering it. A quick check shows that search.js sets window.location=pathtoroot + url so I first suspected that pathtoroot was undefined, but each page defines pathtoroot including e.g. index.html so ...

I also see two scripts that fail to load:

module-search-index.js
tag-search-index.js

All other javadoc for Tomcat [8.5, 9.0, 10.1, 11.0] have these two files, but not 10.0.

The files don't look very complicated and don't appear to contain anything specific to each of those other javadoc sets, so I simply copied them from one other directory into 10.0. It didn't work. There is obviously some other support that needs to be added in order to get it working.

Re-generating the javadoc using Java 11.0.25+9 give me a working local javadoc search.

How important is it that the javadoc on the website is built with the release version of 10.0.27? I'm guessing ... not at all.

Shall I update the website with working javadoc search?

-chris


---------------------------------------------------------------------
To unsubscribe, e-mail: users-unsubscr...@tomcat.apache.org
For additional commands, e-mail: users-h...@tomcat.apache.org

Reply via email to