mirror of
https://gitlab.kitware.com/cmake/cmake.git
synced 2026-10-06 04:03:27 +03:00
Help: Add target for policy deprecation link
In the policy pages' "deprecated by definition" box, instead of linking that phrase to the `cmake-policies(7)` manual page, add a label (`_cmake-policies-intro`) above the "Introduction" section, and link to that label using the `:ref:` role instead. This avoids landing the reader at the `cmake-policies(7)` table of contents, which is now long enough that it's likely to fill their entire screen unless they scroll down! As an added bonus, using `:ref:` instead of `:manual:` avoids applying monospace formatting to the link text.
This commit is contained in:
1 parent
271f358f1f
commit
7f7175e0cd
2 files changed
+3
-1
No files matched your search
@@ -7,6 +7,8 @@ cmake-policies(7)
|
||||
|
||||
.. contents::
|
||||
|
||||
.. _cmake-policies-intro:
|
||||
|
||||
Introduction
|
||||
============
|
||||
|
||||
|
||||
@@ -1,4 +1,4 @@
|
||||
.. note::
|
||||
The ``OLD`` behavior of a policy is
|
||||
:manual:`deprecated by definition <cmake-policies(7)>`
|
||||
:ref:`deprecated by definition <cmake-policies-intro>`
|
||||
and may be removed in a future version of CMake.
|
||||
Reference in new issue
Block a user