Re: [PATCH] docs: add advanced search for kernel documentation

[Randy Dunlap]

On 3/21/26 6:12 PM, Rito Rhymes wrote:
> I was using the in-tree build (`make htmldocs`) before. I just ran
> fresh rebuilds with both in-tree and out-of-tree (`make O=DOCS
> htmldocs`) builds, and I got identical search results of 280 hits for
> "futex" when serving both.
> 
> I ran the builds and served the output on Linux/x86_64, and tested the
> pages in Chrome, Edge, and Firefox on Windows.
> 
> So at this point I have not been able to reproduce the "no output"
> behavior with either build mode, I think we can rule out build mode
> quirks.
> 
> More debugging:
> 
> As a comparison, WITHOUT using my patch, upstream only build, does the
> normal Quick Search work? What results do you get for Futex?

Yes:
Search Results
Search finished, found 225 pages matching the search query.


> WITH my patch, do Quick Search return any results for Futex?

No. Just a search dialog page with no matches listed.


> How are you opening or serving the generated docs? For example, via a
> local web server (`http://...`) or directly from disk (`file://...`)?
> I am serving the generated output over HTTP locally via
> `python -m http.server`.

file://...

> What Sphinx version are you using for the build?
> I built with Sphinx 9.1.0.

8.2.3-4.2 (latest from openSUSE Tumbleweed, rolling updates)

> If possible, could you also check in the browser network tab whether
> `_static/kernel-search.js`, `_static/language_data.js`, and
> `searchindex.js` are all loading successfully?

They appear to be (this is new to me).
They are listed and I don't see any errors associated with them.

-- 
~Randy