Re: [PATCH 0/1] fix rustdoc build detection

From: Mauro Carvalho Chehab
Date: Mon Nov 17 2025 - 05:51:34 EST


On Mon, Nov 17, 2025 at 10:19:18AM +0100, Miguel Ojeda wrote:
> On Mon, Nov 17, 2025 at 10:13 AM Mauro Carvalho Chehab
> <mchehab+huawei@xxxxxxxxxx> wrote:
> >
> > Another alternative would be to modify the rustdoc target inside
> > rust Makefile to make it dependent on htmldocs, but that would require
> > more work.
>
> Why? No, there is no need to build any htmldocs to build the Rust
> documentation, so that would be wrong.

Sure, Sphinx (including kernel-doc) build and rust doca build are
independent. Yet, Makefile "htmldocs" target currently does both.

It could make sense to have a separate target if one want to build
them both, e.g. something like:

make rustdoc - builds just rust docs
make htmldocs - builds all non-rust docs
make allhtmldocs - makes both

On other words, we could add a rule like:

rusthtmldocs: rustdoc htmldocs

and simplify the makefile and the wrapper.

PS.: I'm using "allhtmldocs" just to make clear about what
I meant. Not sure if this would be the best name for the
joint html output target.

--
Thanks,
Mauro