Re: [PATCH 0/4] docs: kernel-doc: fix export selection and error handling
From: Weijie Yuan
Date: Sat Nov 14 2026 - 01:46:36 EST
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.