mirror of
https://gitlab.kitware.com/cmake/cmake.git
synced 2026-10-07 04:02:23 +03:00
Matthew Woehlke
46ede9b46d
Add a new CMake domain role for referencing fields in CMake presets. This has two main purposes. First, it replaces generic references (which were excessively long and required explicit titles) and acts as an improved version of the `ref` role by allowing the always-present `CMakePresets.` prefix to be elided. Second, unlike generic references which silently degrade to broken links that are only caught by `linkcheck`, broken references are flagged immediately in regular Sphinx builds. Therefore, this both improves presentation by bringing line lengths back under control, and reduces errors by making bad references immediately detectable. There is also a small change in rendering, as field references are now rendered as literals. This is consistent with how fields are mentioned in prose when they are not linked.