From 2195beca9f179d239ae10800adbfc8d033bd8f7c Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Petr=20=C5=A0pa=C4=8Dek?= Date: Thu, 11 Sep 2025 10:51:02 +0200 Subject: [PATCH 1/2] Reorder appendices in ARM The new order hopefully reflects likelihood of someone reading from start to the end: DNSSEC Guide Manual Pages General DNS Reference Information Release Notes Changelog A Brief History of the DNS and BIND (cherry picked from commit ed0db245bef8eb977655f794f2263ccb954ddf74) --- doc/arm/index.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/doc/arm/index.rst b/doc/arm/index.rst index 1359ff36e9..8d0e36e2a6 100644 --- a/doc/arm/index.rst +++ b/doc/arm/index.rst @@ -36,9 +36,9 @@ BIND 9 Administrator Reference Manual :name: appendices :maxdepth: 2 + dnssec-guide + manpages + general notes changelog - dnssec-guide history - general - manpages From 118736be43434f78bbc74d5be20a40c570b613f3 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Petr=20=C5=A0pa=C4=8Dek?= Date: Thu, 11 Sep 2025 11:06:21 +0200 Subject: [PATCH 2/2] Prevent Sphinx from messing up syntax with "smartquotes" feature Sphinx's smartquotes feature was rewriting -- to en-dash, "" to proper English quotes etc. This was messing up syntax at unpredictable places. Disable this feature instead of attempting to escape all the places in the manual. (cherry picked from commit 66e58d33158c982b1ce67455d78809a927a0d155) --- doc/arm/conf.py | 2 ++ 1 file changed, 2 insertions(+) diff --git a/doc/arm/conf.py b/doc/arm/conf.py index f6fd1ab05d..c28ddfaa73 100644 --- a/doc/arm/conf.py +++ b/doc/arm/conf.py @@ -185,6 +185,8 @@ exclude_patterns = ["_build", "Thumbs.db", ".DS_Store", "*.inc.rst"] # The master toctree document. master_doc = "index" +smartquotes = False + # -- Options for HTML output ------------------------------------------------- # The theme to use for HTML and HTML Help pages. See the documentation for