pipewire/doc/meson.build

doxyfile_conf = configuration_data()
doxyfile_conf.set('PACKAGE_NAME', meson.project_name())
doxyfile_conf.set('PACKAGE_VERSION', meson.project_version())
doxyfile_conf.set('top_srcdir', meson.source_root())
doxyfile_conf.set('top_builddir', meson.build_root())

if find_program('dot', required: false).found()
  doxyfile_conf.set('HAVE_DOT', 'YES')
else
  doxyfile_conf.set('HAVE_DOT', 'NO')
endif

inputs = []
foreach h : pipewire_headers
  inputs += meson.source_root() / 'src' / 'pipewire' / h
endforeach
foreach h : pipewire_sources
  inputs += meson.source_root() / 'src' / 'pipewire' / h
endforeach

# SPA headers use static inline functions. Doxygen doesn't extract those
# unless we have EXTRACT_STATIC set - but we don't want it to extract
# everything in the rest of the tree.
# The shell script here basically does a:
#   cp spa/* builddir/spa/ && sed -i 's/^static//' buildir/spa/**.h
# The copied files are passed to doxygen as input and they are parsed as
# normal functions.
# Because this uses globbing, this target won't rebuild if the headers
# change but meh.
spa_header_dirs = []
sed = find_program('sed', required: false)
if sed.found()
  spa_srcdir = meson.source_root() / 'spa' / 'include' / 'spa'
  spa_dstdir = meson.current_build_dir() / 'spa'
  spa_strip_static = custom_target(
    'spa-strip-static',
    command: [ find_program('strip-static.sh'), spa_srcdir, spa_dstdir ],
    build_by_default: true,
    output: 'spa',
  )
  spa_header_dirs += spa_dstdir
else
  spa_strip_static = []
endif

extra_docs = [
  'pipewire-overview.md',
  'pipewire-design.md',
  'pipewire-architecture.md',
  'pipewire-objects-design.md',
  'tutorial.dox',
  'tutorial1.dox',
  'tutorial2.dox',
  'tutorial3.dox',
  'tutorial4.dox',
  'tutorial5.dox',
  'tutorial6.dox',
  'spa-index.md',
  'spa-design.md',
  'spa-pod.md',
  'spa-buffer.md',
  'pulseaudio.md',
]

foreach extra : extra_docs
  inputs += meson.source_root() / 'doc' / extra
endforeach

cssfiles = [
  meson.source_root() / 'doc' / 'doxygen-awesome.css',
  meson.source_root() / 'doc' / 'custom.css'
]

doxyfile_conf.set('inputs', ' '.join(inputs + [spa_dstdir]))
doxyfile_conf.set('cssfiles', ' '.join(cssfiles))

doxyfile = configure_file(input: 'Doxyfile.in',
                          output: 'Doxyfile',
                          configuration: doxyfile_conf)

docdir = get_option('docdir')
if docdir == ''
  docdir = pipewire_datadir / 'doc' / meson.project_name()
endif

html_target = custom_target('pipewire-docs',
                            input: [ doxyfile ] + inputs + cssfiles,
                            output: [ 'html' ],
                            command: [ doxygen, doxyfile ],
                            depends: spa_strip_static,
                            install: true,
                            install_dir: docdir)