[PATCH 0/1] add a make target to generate man pages from kernel-doc

Mauro Carvalho Chehab posted 1 patch 1 month, 1 week ago
There is a newer version of this series
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
[PATCH 0/1] add a make target to generate man pages from kernel-doc
Posted by Mauro Carvalho Chehab 1 month, 1 week ago
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@kernel.org/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