Skip to content

Add generator for modern buildsystem documentation

Simon Praetorius requested to merge feature/modern-cmake-documentation-generator into master

Summary

The buildsystem documentation generator does not support multi-line comments, rst systax and modern CMake documentation commands as used in CMake itself. This MR adds some functionality and redirects to a python module to do the rest.

Discussion

How to specify the python package dependencies for the buildsystem documentation generator? The necessary requirement is sphinxcontrib-moderncmakedomain. Should this be put into the dune.module file? Or into the pyproject.toml file?

TODO

  • Squash the Commits
  • Add Changelog entry
  • Improve the table of content generation
Edited by Simon Praetorius

Merge request reports