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: make all manpages with Doxygen

Browse source 
Use (fixed-up) Doxygen manpage output for all program & module manpages.

This also allows formatting the manual pages properly in the HTML docs.

The Markdown pages work properly only with Doxygen >= 1.9.7, older
versions put them to wrong place in the HTML docs.
This commit is contained in:
Pauli Virtanen 2023-11-21 21:31:16 +02:00
parent de954655bc
commit 0fbcc87314
49 changed files with 1717 additions and 2012 deletions
Download patch file Download diff file Expand all files Collapse all files

27
meson.build
View file

@ -485,36 +485,17 @@ if alsa_dep.found()
subdir('pipewire-alsa/tests')
endif
generate_manpages = false
if get_option('man').allowed()
rst2man = find_program('rst2man', required: false)
if not rst2man.found()
rst2man = find_program('rst2man.py', required: get_option('man'))
endif
if rst2man.found()
generate_manpages = true
endif
endif
summary({'Manpage generation': generate_manpages}, bool_yn: true)
subdir('man')
doxygen = find_program('doxygen', required : get_option('docs'))
pymod = import('python')
python = pymod.find_installation('python3', required: get_option('docs'))
generate_docs = doxygen.found() and python.found()
generate_extra_manpages = false
if doxygen.found() and python.found()
if generate_manpages
pandoc = find_program('pandoc', required: get_option('man-extra'))
generate_extra_manpages = pandoc.found()
endif
if generate_docs
subdir('doc')
endif
summary({'Extra manpage generation': generate_extra_manpages}, bool_yn: true)
summary({'Documentation and man pages ': generate_docs}, bool_yn: true)
setenv = find_program('pw-uninstalled.sh')
run_target('pw-uninstalled',