mirrors/pipewire
1
0
Fork 0
mirror of https://gitlab.freedesktop.org/pipewire/pipewire.git synced 2025-10-29 05:40:27 -04:00
Code Issues Projects Releases Packages Wiki Activity Actions

doc: generate man-pages also for pipewire modules

Browse source 
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
Download patch file Download diff file Expand all files Collapse all files

30
doc/meson.build
View file

@ -166,3 +166,33 @@ html_target = custom_target('pipewire-docs',
command: [ doxygen, doxyfile ],
install: true,
install_dir: docdir)
if generate_module_manpages
module_man_rst_py = meson.project_source_root() / 'doc' / 'module-man-rst.py'
module_man_defines = []
foreach m : manpage_conf.keys()
if m != 'LIBPIPEWIRE_MODULES'
module_man_defines += ['-D', m, manpage_conf.get(m)]
endif
endforeach
foreach m : module_sources
name = m.split('.c').get(0)
file = 'libpipewire-' + name + '.7'
rst = custom_target(file + '.rst',
command : [python, module_man_rst_py, pandoc, name, '@INPUT@' ] + module_man_defines,
input : [ html_target ],
depend_files : [ module_man_rst_py ],
output : file + '.rst',
capture : true
)
custom_target(file,
output : file,
input : rst,
command : [rst2man, '@INPUT@', '@OUTPUT@'],
install : true,
install_dir : get_option('mandir') / 'man7')
endforeach
endif