[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