Re: [PATCH RFCv2 0/5]Implement kernel-doc in Python

From
Mauro Carvalho Chehab <mchehab+huawei@kernel.org>
Date
2025-02-14 08:02:26
Also in
linux-arch, linux-hardening, lkml
Reply to
Randy Dunlap, 2025-02-14
Em Thu, 13 Feb 2025 19:15:28 -0800
Randy Dunlap [off-list ref] escreveu:
Hi Mauro,


On 2/13/25 4:06 AM, Mauro Carvalho Chehab wrote:
quoted
Hi Jon,

That's the second version of the Python kernel-doc tool.

As the previous version, I tried to stay as close as possible of the original
Perl implementation, as it helps to double check if each function was 
properly translated to Python.  This have been helpful debugging troubles
that happened during the conversion.  
Since this new version is supposed to be bug-for-bug compatible,
Yes, that's the goal: I'm checking all discrepancies by hand to ensure that
the output net result will be identical at the final version - maybe
except for blank lines/whitespace (and eventually empty Return sections
that the current script produces). Getting blank lines and whitespaces identical
have been hard.

So, yeah, if something is not handled well by the Perl version, the
Python version shall produce an identical result. I'm refraining to
try fixing any already existing issues there.
I will wait
until later to test the current known bugs that I know about in (Perl) kernel-doc.

For a preview of most of them, you can read:
https://lore.kernel.org/linux-doc/3a6a7dd0-72f1-44c6-b0bc-b1ce76fca76a@infradead.org/ (local)

and its follow-up email (today).

There are quite a few problems with parsing function parameters that use
typedefs.
Thanks for that!

Let's address when we finish the transition.

Thanks,
Mauro
Thread (10 messages) 10 messages, 3 authors, last reply 2025-02-14
Keyboard shortcuts
hback out one level
jnext message in thread / next series-diff position
kprevious message in thread / previous series-diff position
ldrill in
Escclose help / fold thread tree
?toggle this help