Re: [PATCH 0/4] docs: kernel-doc: fix export selection and error handling

[Weijie Yuan <wy@wyuan.org>]

On Sat, Nov 14, 2026 at 01:40:28PM +0800, 闲逛 wrote:
> Hi Jonathan and Mauro,
> 
> This series fixes four reproducible kernel-doc issues:
> 
>   1. Multi-file export filtering reuses the first input's exports.
>   2. Environment warning-as-error settings do not affect the exit status.
>   3. YAML error paths call sys.exit() without importing sys.
>   4. A separate -export-file triggers a missing-xforms TypeError.
> 
> Each fix includes CLI regression coverage. The warning-policy tests also
> cover KDOC_WERROR=0, empty overrides, and command-line precedence.
> 
> Validation on Windows (Python 3.12) and Ubuntu 24.04 under WSL2
> (Python 3.12.3):
> 
>   python3 -B -X utf8 -m unittest discover -s tools/unittests
> 
>   Ran 131 tests: 127 passed, 4 existing expected failures.
> 
> The series is based on mainline commit
> b3dfbde62cf1981c4638939c159dfd087b7a72e9.

> A complete Sphinx documentation build has not been performed.

May I ask why? You could just run 'make htmldocs'.

> I could not verify docs-next because the server's TLS connection
> failed; checking for equivalent pending mailing-list patches is also
> incomplete.

I don't believe you can not clone Jon's repo and checkout docs-next
branch. Is there any reason? (Looks like git.lwn.net is doing a pretty
good job of keeping AI crawlers out.;)) And I suspect that this part is
the output of your agent. :)

> Codex assisted with reproducing the failures, preparing the fixes and
> regression tests, and executing the tests. The task was to inspect and
> repair kernel-doc behavior in a local Linux source tree. I have reviewed
> the changes and requested that my Signed-off-by be recorded.

Thanks for the disclosure, but this may not be put in the commit message
of your patches. They should better be under '---'.

And please see also: "no attachments"

https://docs.kernel.org/process/submitting-patches.html#no-mime-no-links-no-compression-no-attachments-just-plain-text

Thanks.