pipewire/doc/tutorial.dox

/** \page page_tutorial Tutorial - The PipeWire API

Welcome to the PipeWire tutorial. The goal is to learn
PipeWire API step-by-step with simple short examples.

- \subpage page_tutorial1
- \subpage page_tutorial2
- \subpage page_tutorial3
- \subpage page_tutorial4
- \subpage page_tutorial5
- \subpage page_tutorial6

*/
doc: change the tutorials to doxygen sources While doxygen can handle markdown pages, support for it is very limited: markdown pages can only be included as a whole page, they get an automatic title (custom titles are possible but aren't standard markdown) and it's not possible to use \subpage without messing with the markdown again. Any markdown page will thus end up as separate item in the doxygen output, not really suitable for generating a good page hiearchy. Let's switch the tutorial to use doxygen directly instead of markdown, short of using code/endcode instead of markdown's ``` there isn't that much difference anyway but it allows us to structure things nicer in the online docs. 2021-05-25 13:08:04 +10:00			`/** \page page_tutorial Tutorial - The PipeWire API`

			`Welcome to the PipeWire tutorial. The goal is to learn`
			`PipeWire API step-by-step with simple short examples.`

			`- \subpage page_tutorial1`
			`- \subpage page_tutorial2`
			`- \subpage page_tutorial3`
			`- \subpage page_tutorial4`
			`- \subpage page_tutorial5`
			`- \subpage page_tutorial6`

			`*/`