Skip to content

GitLab

The TS-GitLab will have to shut down towards the end of the year — please think about migrating your projects to GitLab.com or GitHub.
(This is still a very early message, meant to keep you informed. There will be more urgent ones in the future.)

Closed
Created by Lukas Riedel@lriedelOwner

Sphinx documentation is broken

The update to Dune v2.5 broke the Sphinx documentation. Apparently, the new Dune macros use a new syntax. At the moment, make doc produces a documentation of the entire CMake API included in Dorie.

Solution: Explicitly call Sphinx via CMake like in this example Use the macro with the new syntax as it is done in dune-testtools.

Preliminary tasks:

  • create new conf.py.in file using sphinx-quickstart
  • install Sphinx into the Dune venv
    • execute Sphinx inside Dune venv when calling make doc or similar
  • change syntax of dune_cmake_sphinx_doc()
  • check Breathe functionality
Edited by Lukas Riedel
To upload designs, you'll need to enable LFS and have an admin enable hashed storage. More information