Re: [PATCH v3 00/33] Implement kernel-doc in Python

Jonathan Corbet
2025-04-14T15:17:58Z

Andy Shevchenko <andriy.shevchenko@intel.com> writes:

> On Wed, Apr 09, 2025 at 12:30:00PM -0600, Jonathan Corbet wrote:
>> Mauro Carvalho Chehab <mchehab+huawei@kernel.org> writes:
>>
>> > This changeset contains the kernel-doc.py script to replace the verable
>> > kernel-doc originally written in Perl. It replaces the first version and the
>> > second series I sent on the top of it.
>>
>> OK, I've applied it, looked at the (minimal) changes in output, and
>> concluded that it's good - all this stuff is now in docs-next. Many
>> thanks for doing this!
>>
>> I'm going to hold off on other documentation patches for a day or two
>> just in case anything turns up. But it looks awfully good.
>
> This started well, until it becomes a scripts/lib/kdoc.
> So, it makes the `make O=...` builds dirty *). Please make sure this doesn't leave
> "disgusting turd" )as said by Linus) in the clean tree.
>
> *) it creates that __pycache__ disaster. And no, .gitignore IS NOT a solution.

If nothing else, "make cleandocs" should clean it up, certainly.

We can also tell CPython to not create that directory at all. I'll run
some tests to see what the effect is on the documentation build times;
I'm guessing it will not be huge...

Thanks,

jon