[PATCH RFC 0/2] Add Kconfig pages and cross-references to Documentation
From: Nícolas F. R. A. Prado
Date: Fri Apr 04 2025 - 10:05:08 EST
This series adds Kconfig pages (patch 1) to the Documentation, and
automarkups CONFIG_* text as cross-references to those pages (patch 2).
There is a huge change in build time with this series, so we'd either
have to so some optimization and/or put this behind a flag in make so it
is only generated when desired (for instance for the online
documentation):
(On an XPS 13 9300)
Before:
real 6m43.576s
user 23m32.611s
sys 1m48.220s
After:
real 11m56.845s
user 47m40.528s
sys 2m27.382s
There are also some issues that were solved in ad-hoc ways (eg the
sphinx warnings due to repeated Kconfigs, by embedding the list of
repeated configs in the script). Hence the RFC.
Signed-off-by: Nícolas F. R. A. Prado <nfraprado@xxxxxxxxxxxxx>
---
Nícolas F. R. A. Prado (2):
docs: Add documentation generation for Kconfig symbols
docs: automarkup: Cross-reference CONFIG_ symbols
Documentation/.gitignore | 2 +
Documentation/Config/index.rst | 17 ++
Documentation/Makefile | 12 +-
Documentation/kbuild/index.rst | 2 +
Documentation/sphinx/automarkup.py | 36 +++-
scripts/kconfig2rst.py | 336 +++++++++++++++++++++++++++++++++++++
6 files changed, 403 insertions(+), 2 deletions(-)
---
base-commit: 405e2241def89c88f008dcb899eb5b6d4be8b43c
change-id: 20250403-kconfig-docs-19d90ba266dd
Best regards,
--
Nícolas F. R. A. Prado <nfraprado@xxxxxxxxxxxxx>