Re: [TECH TOPIC] Kernel documentation - update and future directions

[Mauro Carvalho Chehab <mchehab+huawei@kernel.org>]

Em Tue, 2 Sep 2025 13:59:38 +0200
Mauro Carvalho Chehab <mchehab+huawei@kernel.org> escreveu:

> Em Tue, 2 Sep 2025 12:15:51 +0100
> Mark Brown <broonie@kernel.org> escreveu:
> 
> > On Tue, Sep 02, 2025 at 12:56:57AM +0200, Mauro Carvalho Chehab wrote:
> >   
> > > If you run:    
> >   
> > > 	 kernel-doc . --none -Wall    
> >   
> > > You won't have troubles with Sphinx slowness. It would be worth timing
> > > it on you machine and see how much time it takes to run. Probably
> > > the run time depends a little bit on the Python version. Not sure how
> > > much optimization it got(*).    
> > 
> > That takes about 90s for me.  
> 
> 
> I wander why here is 3 times faster... disk cache? python version?
> faster ssd?
> 
> What python version are you using?

Heh, after running twice or three times to avoid cache issues, I tested
running it on my machine with two different python versions:

$ time python3.13 scripts/kernel-doc.py . --none

real    0m31,660s
user    0m30,911s
sys     0m0,588s

$ time python3.9 scripts/kernel-doc.py . --none

real    0m59,004s
user    0m58,014s
sys     0m0,730s

$ time python3.6 scripts/kernel-doc.py . --none

real    1m16,494s
user    1m15,400s
sys     0m0,765s

(after a fix I'm about to send to prevent lots of output about
 python version)

So, yeah, Python version seems to be one of the reasons why it is
taking so long on your machine.

Thanks,
Mauro