Re: [PATCH] Makefile: Let kernel-doc.py use PYTHON3 override

[Nathan Chancellor <nathan@kernel.org>]

On Mon, Nov 03, 2025 at 01:14:19PM +0100, Jean Delvare wrote:
> It is possible to force a specific version of python to be used when
> building the kernel by passing PYTHON3= on the make command line.
> However kernel-doc.py is currently called with python3 hard-coded and
> thus ignores this setting.
> 
> Use PYTHON3 to call kernel-doc.py so that the desired version of
> python is used.
> 
> Signed-off-by: Jean Delvare <jdelvare@suse.de>

I see one use of KERNELDOC in tools/docs/sphinx-build-wrapper that would
appear to break with this change? Does it matter? I am not familiar with
the docs build. Otherwise, this seems like the correct thing to do.

> ---
>  Makefile |    2 +-
>  1 file changed, 1 insertion(+), 1 deletion(-)
> 
> --- linux-6.17.orig/Makefile
> +++ linux-6.17/Makefile
> @@ -460,7 +460,7 @@ HOSTPKG_CONFIG	= pkg-config
>  
>  # the KERNELDOC macro needs to be exported, as scripts/Makefile.build
>  # has a logic to call it
> -KERNELDOC       = $(srctree)/scripts/kernel-doc.py
> +KERNELDOC       = $(PYTHON3) $(srctree)/scripts/kernel-doc.py
>  export KERNELDOC
>  
>  KBUILD_USERHOSTCFLAGS := -Wall -Wmissing-prototypes -Wstrict-prototypes \
> 
> 
> -- 
> Jean Delvare
> SUSE L3 Support