doc: add documentation for pipewire-pulse modules

Add (minimal) reference documentation for each pipewire-pulse module.

Add some preprocessing to substitute @pulse_module_options@ in docs from
PW_KEY_MODULE_USAGE so the module options don't need to be repeated.

Produce Doxygen docs + generate manpages pipewire-pulse-modules.7,
pipewire-pulse-module-*.7
This commit is contained in:
Pauli Virtanen 2023-11-19 23:08:09 +02:00 committed by Wim Taymans
parent 0ae797ea28
commit 843e733479
40 changed files with 979 additions and 302 deletions

View file

@ -500,13 +500,13 @@ summary({'Manpage generation': generate_manpages}, bool_yn: true)
subdir('man')
doxygen = find_program('doxygen', required : get_option('docs'))
if doxygen.found()
pymod = import('python')
python = pymod.find_installation('python3', required: get_option('docs'))
if doxygen.found() and python.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()
generate_module_manpages = pandoc.found()
endif
summary({'Module manpage generation': generate_module_manpages}, bool_yn: true)