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.21.1~1^2~1
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=0d97fe02bcb148742eb7c6e6873162adebeae04c;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 cf1ba1b12cc..2d8f4b5829d 100644
--- a/doc/arm/reference.rst
+++ b/doc/arm/reference.rst
@@ -6398,7 +6398,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.
 
@@ -6410,7 +6412,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.
 
@@ -6578,7 +6582,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.