doc: add the various markdown prose docs to the doxygen output

Note that the order of the includes matters - that's how doxygen will sort
them. There is no specific structure other than the include order - one reason
why the headers are being changed. Without polluting the markdown files with
doxygen commands we cannot use \subpage, so all files convert to a regular
\page and are listed as flat hierarchy in the sidebar (and in Related Pages).

Changing the headers at least provides some visual grouping with comon
prefixes.
This commit is contained in:
Peter Hutterer 2021-05-07 09:09:45 +10:00
parent d10381dfc3
commit ac05f6bb03
14 changed files with 50 additions and 19 deletions

View file

@ -18,6 +18,29 @@ foreach h : pipewire_sources
inputs += meson.source_root() / 'src' / 'pipewire' / h
endforeach
extra_docs = [
'overview.md',
'design.txt',
'architecture.md',
'objects_design.md',
'tutorial-index.md',
'tutorial1.md',
'tutorial2.md',
'tutorial3.md',
'tutorial4.md',
'tutorial5.md',
'tutorial6.md',
'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
doxyfile_conf.set('inputs', ' '.join(inputs))
doxyfile = configure_file(input: 'Doxyfile.in',