doc: generate man-pages also for pipewire modules

Use pandoc + some processing to convert Doxygen html output to man
pages.

Requires pandoc & python for building.

Generates manpages: libpipewire-modules.7, libpipewire-module-*.7
This commit is contained in:
Pauli Virtanen 2023-11-18 20:04:06 +02:00 committed by Wim Taymans
parent 62f69581bf
commit 21854f24a5
7 changed files with 265 additions and 0 deletions

View file

@ -501,6 +501,15 @@ subdir('man')
doxygen = find_program('doxygen', required : get_option('docs'))
if doxygen.found()
generate_module_manpages = get_option('docs').enabled() and get_option('man').enabled()
if generate_manpages
pymod = import('python')
python = pymod.find_installation('python3', required: generate_module_manpages)
pandoc = find_program('pandoc', required: generate_module_manpages)
generate_module_manpages = python.found() and pandoc.found()
endif
summary({'Module manpage generation': generate_module_manpages}, bool_yn: true)
subdir('doc')
endif