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

[Randy Dunlap <rdunlap@infradead.org>]

Hi,

On 11/3/25 10:56 AM, Nathan Chancellor wrote:
> 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.

I think there has been some discussion of these matters on the linux-doc
mailing list (adding it here).

>> ---
>>  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
> 

-- 
~Randy