PDF/LaTeX build of the documentation fails

[elliotfontaine]

The LaTeX build of the documentation fails.

File "/home/docs/checkouts/readthedocs.org/user_builds/rtmet/envs/latest/lib/python3.12/site-packages/sphinx/writers/latex.py", line 785, in visit_desc_content
    assert self.in_desc_signature
           ^^^^^^^^^^^^^^^^^^^^^^
AssertionError

Exception occurred:
  File "/home/docs/checkouts/readthedocs.org/user_builds/rtmet/envs/latest/lib/python3.12/site-packages/sphinx/writers/latex.py", line 785, in visit_desc_content
    assert self.in_desc_signature
           ^^^^^^^^^^^^^^^^^^^^^^
AssertionError
The full traceback has been saved in /tmp/sphinx-err-dj3akq3d.log, if you want to report the issue to the developers.
Please also report this if it was a user error, so that a better error message can be provided next time.
A bug report can be filed in the tracker at <https://github.com/sphinx-doc/sphinx/issues>. Thanks!

This may be related to

• LaTeX docs build ends in failure with Sphinx 4.5.0 sphinx-doc/sphinx#10332
• LaTeX documentation doesn't build with Sphinx 4.5.0 coq/coq#15956

As it occured after the rose config file autodoc was introduced by #20, it may be hard to debug if it's because of the exotic sphinx extensions.
A fix could be found by simply changing sphinx / rtd versions.

This will require further investigation. For now, let's simply disable the PDF output.