Build ARM docs even on RHEL9

Sphinx on RHEL9 does not case-insensitive references. Make reference
itself link to correct terms, but use just presentation name to be
lowercase.
This commit is contained in:
Petr Menšík 2022-09-24 20:25:48 +02:00
parent d31af5c89a
commit 41841ff366
2 changed files with 68 additions and 1 deletions

View File

@ -0,0 +1,62 @@
From e3dad016ce5a1e881a09f90e32279604ce3b8dbe Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Petr=20Men=C5=A1=C3=ADk?= <pemensik@redhat.com>
Date: Sat, 24 Sep 2022 14:22:20 -0400
Subject: [PATCH] Compatibility for building ARM on older sphinx
Make documentation building successful even on RHEL9 sphinx 3.4.3. It
does not like case-insensitive matching of terms, so provide lowercase
text description with Uppercase word reference.
---
doc/arm/dnssec.inc.rst | 2 +-
doc/arm/reference.rst | 8 ++++----
2 files changed, 5 insertions(+), 5 deletions(-)
diff --git a/doc/arm/dnssec.inc.rst b/doc/arm/dnssec.inc.rst
index 0d72000..f4810ae 100644
--- a/doc/arm/dnssec.inc.rst
+++ b/doc/arm/dnssec.inc.rst
@@ -282,7 +282,7 @@ NSEC3
To sign using :ref:`NSEC3 <advanced_discussions_nsec3>` instead of :ref:`NSEC
<advanced_discussions_nsec>`, add an NSEC3PARAM record to the initial update
-request. The :term:`OPTOUT <opt-out>` bit in the NSEC3
+request. The :term:`OPTOUT <Opt-out>` bit in the NSEC3
chain can be set in the flags field of the
NSEC3PARAM record.
diff --git a/doc/arm/reference.rst b/doc/arm/reference.rst
index c6fd9f5..e8832d9 100644
--- a/doc/arm/reference.rst
+++ b/doc/arm/reference.rst
@@ -35,7 +35,7 @@ The file :file:`named.conf` may contain three types of entities:
Block
:ref:`Blocks <configuration_blocks>` are containers for :term:`statements
- <statement>` which either have common functionality - for example,
+ <Statement>` which either have common functionality - for example,
the definition of a cryptographic key in a :namedconf:ref:`key` block - or which
define the scope of the statement - for example, a statement which appears
in a :namedconf:ref:`zone` block has scope only for that zone.
@@ -68,7 +68,7 @@ The file :file:`named.conf` may contain three types of entities:
more argument/value pairs. The :any:`also-notify` statement may take a number
of such argument/value pairs, such as ``also-notify port 5353;``,
where ``port`` is the argument and ``5353`` is the corresponding value.
- - Statements can appear in a single :term:`block` - for
+ - Statements can appear in a single :term:`block <Block>` - for
example, an :namedconf:ref:`algorithm` statement can appear only in a
:namedconf:ref:`key` block - or in multiple blocks - for example, an
:any:`also-notify` statement can appear in an :namedconf:ref:`options`
@@ -6555,8 +6555,8 @@ The following options can be specified in a :any:`dnssec-policy` statement:
of the indicated length.
.. warning::
- Do not use extra :term:`iterations`, :term:`salt`, and
- :term:`opt-out` unless their implications are fully understood.
+ Do not use extra :term:`iterations <Iterations>`, :term:`salt <Salt>`, and
+ :term:`opt-out <Opt-out>` unless their implications are fully understood.
A higher number of iterations causes interoperability problems and opens
servers to CPU-exhausting DoS attacks.
--
2.37.3

View File

@ -68,7 +68,7 @@ Summary: The Berkeley Internet Name Domain (BIND) DNS (Domain Name System) serv
Name: bind9-next
License: MPLv2.0
Version: 9.19.5
Release: 1%{?dist}
Release: 2%{?dist}
Epoch: 32
Url: https://www.isc.org/downloads/bind/
#
@ -114,6 +114,8 @@ Patch25: bind-9.18-pkcs11-engine-remove-deadcode.patch
# Since 9.19.5 it does not apply and has not simple backport
# option
#Patch26: bind-9.18-unittest-netmgr-unstable.patch
# Fixes ARM building on EPEL9
Patch27: bind-9.19-doc-arm-rhel9.patch
%{?systemd_ordering}
Requires: coreutils
@ -962,6 +964,9 @@ fi;
%endif
%changelog
* Sat Sep 24 2022 Petr Menšík <pemensik@redhat.com> - 32:9.19.5-2
- Build ARM docs even on RHEL9
* Fri Sep 23 2022 Petr Menšík <pemensik@redhat.com> - 32:9.19.5-1
- Update to 9.19.5