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

From: 闲逛

Date: Sat Nov 14 2026 - 04:06:03 EST


Hi Weijie,

Thank you for reviewing my submission, and sorry for the mistakes.
Although I have been familiar with and using Linux for nearly ten
years, this is my first time submitting a bug fix to the kernel
community, and I still have a lot to learn about the process.

This v2 series fixes four kernel-doc issues:

1. Pass the required transforms when parsing separate export files.
2. Combine input and additional export sources correctly.
3. Honor environment warning-as-error settings in the exit status.
4. Import sys for YAML failure diagnostics.

I stopped after the regression tests, which was insufficient
validation. I should have completed the documentation build before
sending v1.

Full documentation builds have now completed on both the unmodified
docs-next base and the revised series, using Ubuntu 24.04 under WSL2
with Python 3.12.3 and Sphinx 7.2.6:

make -j4 O=../baseline-lf-build htmldocs SPHINXOPTS='-j4'
make -j4 O=../patched-build htmldocs SPHINXOPTS='-j4'

Both commands returned exit status 0 and generated 4,138 HTML pages.
Both logs contain the same 92 diagnostic lines after normalizing
source and output paths; the revised series adds no new diagnostics.

The failure was specific to my HTTPS attempt. Fetching through
git://git.lwn.net/linux.git, as listed in MAINTAINERS, worked.
My earlier explanation was incomplete.

The revised series is now based on docs-next commit:
2138148bf44fd84d3e0a863f0e8cb3627cdcc606

The follow-up review also identified missing coverage for combining
input and additional export files, and for relative SRCTREE paths.
These cases are now fixed and covered by regression tests. The full
suite on the revised docs-next tree runs 137 tests: 133 pass, with
four pre-existing expected failures.

I have also read the submission instructions you linked. I will send
v2 as separate inline plain-text patch emails, without attachments.

Thank you for your time and guidance.

Best regards,
yuehua-meng