weston/doc/sphinx/toc/meson.build

# you need to add here any files you add to the toc directory as well
files = [
	'libweston.rst',
	'test-suite.rst',
	'test-suite-api.rst',
]

foreach file : files
	configure_file(input: file, output: file, copy: true)
endforeach

subdir('libweston')
build: Add sphinx/breathe support for generating documentation This is adds basic configuration files for doxygen and for breathe, which is a doxygen-to-sphinx bridge that can document C symbols. Breathe is configured with default project 'weston' and implicitly adds :members: and :undoc-members: to breathe configuration options. This allows a shorter way to call breathe directives without the need specify the project and also to display implicitly all the members, documented or not. A 'docs' run_target to force the docs to be re-built has been added. Initially (the first time the build system is ran) the documentation will automatically be built, but later re-builds will require the use of the 'docs' target. This avoid further delays in building weston but in the same time allows the possiblity to update/improve the documentation bits to those who want that. Signed-off-by: Marius Vlad <marius.vlad@collabora.com> 2019-06-14 12:41:02 +03:00			`# you need to add here any files you add to the toc directory as well`
doc: overview of the test suite This should lower the barrier to entry for writing more tests. Signed-off-by: Pekka Paalanen <pekka.paalanen@collabora.com> 2019-11-18 16:13:19 +02:00			`files = [`
			`'libweston.rst',`
			`'test-suite.rst',`
			`'test-suite-api.rst',`
			`]`
build: Add sphinx/breathe support for generating documentation This is adds basic configuration files for doxygen and for breathe, which is a doxygen-to-sphinx bridge that can document C symbols. Breathe is configured with default project 'weston' and implicitly adds :members: and :undoc-members: to breathe configuration options. This allows a shorter way to call breathe directives without the need specify the project and also to display implicitly all the members, documented or not. A 'docs' run_target to force the docs to be re-built has been added. Initially (the first time the build system is ran) the documentation will automatically be built, but later re-builds will require the use of the 'docs' target. This avoid further delays in building weston but in the same time allows the possiblity to update/improve the documentation bits to those who want that. Signed-off-by: Marius Vlad <marius.vlad@collabora.com> 2019-06-14 12:41:02 +03:00
			`foreach file : files`
			`configure_file(input: file, output: file, copy: true)`
			`endforeach`

			`subdir('libweston')`