Introducing documentation with Sphinx #526

Merged
gaisser merged 3 commits from mueller/sphinx-docs into development 2021-12-06 15:05:30 +01:00

3 Commits

Author SHA1 Message Date
Robin Müller 4a5204d6f6
small fix for helper script 2021-12-06 14:46:31 +01:00
Robin Müller df45f02c39
script fixes, odd behaviour 2021-12-03 14:55:00 +01:00
Robin Müller c2bf09d506 Introducing documentation with Sphinx
This PR introduces the generation of documentation based on
this excellent blog post: https://devblogs.microsoft.com/cppblog/clear-functional-c-documentation-with-sphinx-breathe-doxygen-cmake/

It combines the tools Sphinx, Doxygen and Breathe to generate good
looking HTML documentation conveniently which can be hosted easily.

The helper scripts were unified and there is now one helper.py script
which can be used to create, build and open both tests and documentation.
"./helper.py -h" can be used to get the different options.

This PR also contains some smaller fixes which were necessary for the docs
to build
2021-12-01 11:17:28 +01:00