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

From: 闲逛

Date: Sat Nov 14 2026 - 00:40:44 EST


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

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.

Thank you for reviewing.

yuehua-meng

yuehua-meng (4):
docs: kernel-doc: collect exports from all input files
docs: kernel-doc: honor environment warning error settings
docs: kernel-doc: import sys for YAML failure diagnostics
docs: kernel-doc: pass transforms when parsing export files

Attachment: 0001-docs-kernel-doc-collect-exports-from-all-input-files.patch
Description: Binary data

Attachment: 0002-docs-kernel-doc-honor-environment-warning-error-sett.patch
Description: Binary data

Attachment: 0003-docs-kernel-doc-import-sys-for-YAML-failure-diagnost.patch
Description: Binary data

Attachment: 0004-docs-kernel-doc-pass-transforms-when-parsing-export-.patch
Description: Binary data