<div dir="ltr"><div dir="ltr"><div dir="ltr"><div dir="ltr"><div dir="ltr"><div dir="ltr">Le jeu. 31 janv. 2019 à 23:09, Torsten Robitzki <<a href="mailto:Torsten@robitzki.de">Torsten@robitzki.de</a>> a écrit :<br></div><div class="gmail_quote"><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><br>We are working on a larger CMake project and we use Sphinx. We use sphinxcontrib.moderncmakedomain as extension, which adds CMake syntax highlighting and sphinx.ext.intersphinx to allow us, to refer to the original CMake documentation.<br></blockquote><div><br></div>Thanks Torsten, that was really useful. I was reluctant to spend time understanding the project's build system (cause it has... no documentation outside the source ;-) but I'm glad I did, now it's mostly just:<br><br>pip3 install --user sphinxcontrib-moderncmakedomain<br><br>.. cmake-module:: does/not/have/to/be/a/module.cmake<br><br>More details at <a href="https://pypi.org/project/sphinxcontrib-moderncmakedomain/">https://pypi.org/project/sphinxcontrib-moderncmakedomain/</a></div><div class="gmail_quote"><br></div><div class="gmail_quote">I didn't try sphinx.ext.intersphinx.<br><br>I'm still a bit confused about Kitware's official stance about this sphinx extension though. Quoting:<br><br>- <a href="https://pypi.org/project/sphinxcontrib-moderncmakedomain/">https://pypi.org/project/sphinxcontrib-moderncmakedomain/</a><br>"I will do my best to keep this module in sync with the one that Kitware uses themselves."<br>apparently a selection from: <a href="https://github.com/Kitware/CMake/tree/master/Utilities/Sphinx/">https://github.com/Kitware/CMake/tree/master/Utilities/Sphinx/</a><br>- <a href="https://cmake.org/cmake/help/v3.13/manual/cmake-developer.7.html">https://cmake.org/cmake/help/v3.13/manual/cmake-developer.7.html</a><br>This manual is intended for reference by developers modifying the CMake source tree itself, and by those authoring externally-maintained modules.<br><br></div><div class="gmail_quote">So while sphinxcontrib-moderncmakedomain seems to just work on any .cmake file, it's not officially supported beyond modules and not distributed for all users in pre-built packages?<br><br>There are (too) many developers who don't want to go anywhere near their own build system. There are even more who don't want to go near a build system with an indirection like CMake. Something like sphinxcontrib-moderncmakedomain would really help there IMHO.<br><br>Marc</div></div></div></div></div></div>