From: Nicki Křížek <nicki@isc.org>
Date: Thu, 5 Sep 2024 13:03:15 +0000 (+0200)
Subject: Fix dnssec-policy options formatting and links in ARM
X-Git-Tag: v9.20.2~1^2~1
X-Git-Url: http://git.ipfire.org/gitweb/?a=commitdiff_plain;h=000b63ad21d0c116a36bba05b3e979c2cd1142b1;p=thirdparty%2Fbind9.git

Fix dnssec-policy options formatting and links in ARM

The statements that already exist in the grammar can't be created with
the namedconf:statement. Use a plain definition list for these
statements and add a manual anchor for each one so links to them can be
created.

Avoid using the :any: syntax in the definition lists, as that just
creates a link to the duplicate and completely unrelated statement,
which just makes the documentation more confusing.
---

diff --git a/doc/arm/reference.rst b/doc/arm/reference.rst
index 32564a8e936..51ece6838aa 100644
--- a/doc/arm/reference.rst
+++ b/doc/arm/reference.rst
@@ -6454,7 +6454,9 @@ The following options can be specified in a :any:`dnssec-policy` statement:
     This indicates the TTL to use when generating DNSKEY resource
     records. The default is 1 hour (3600 seconds).
 
-:any:`inline-signing`
+.. _dnssec-policy-inline-signing:
+
+inline-signing
    :tags: dnssec
    :short: Specifies whether BIND 9 maintains a separate signed version of a zone.
 
@@ -6466,7 +6468,9 @@ The following options can be specified in a :any:`dnssec-policy` statement:
 
    This behavior is enabled by default.
 
-.. keys
+.. _dnssec-policy-keys:
+
+keys
    :tags: dnssec
    :short: Specifies the type of keys to be used for DNSSEC signing.
 
@@ -6634,7 +6638,9 @@ The following options can be specified in a :any:`dnssec-policy` statement:
     This is similar to :any:`signatures-validity`, but for DNSKEY records.
     The default is ``P2W`` (2 weeks).
 
-:any:`max-zone-ttl`
+.. _dnssec-policy-max-zone-ttl:
+
+max-zone-ttl
    :tags: zone, query
    :short: Specifies a maximum permissible time-to-live (TTL) value, in seconds.