[PATCH 0/1] add a make target to generate man pages from kernel-doc
From: Mauro Carvalho Chehab
Date: Tue Aug 26 2025 - 09:57:30 EST
Currently, generation of manpages is hacky: one needs to run
kernel-doc over c source files and then use an extra script to
split results.
The new kernel-doc tool supports multiple files and even dirs,
so there's no need to use git ls-files anymore.
Yet, it produces a single output. Change the logic to add, instead
a target to docs Makefile to produce them, moving the split
and build logic to sphinx-build-wrapper.
That allows honoring SPHINXDIRS when they point to a subdir,
while scanning all files by default.
This series comes after:
https://lore.kernel.org/linux-doc/cover.1756138805.git.mchehab+huawei@xxxxxxxxxx/T/#t
Mauro Carvalho Chehab (1):
docs: add support to build manpages from kerneldoc output
Documentation/Makefile | 3 +-
Documentation/doc-guide/kernel-doc.rst | 19 ++-----
Makefile | 2 +-
scripts/split-man.pl | 28 ----------
tools/docs/sphinx-build-wrapper | 77 ++++++++++++++++++++++++--
5 files changed, 80 insertions(+), 49 deletions(-)
delete mode 100755 scripts/split-man.pl
--
2.51.0