From 2f2c312c4f67854f58cc65215ce09d3be34ce66c 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 5ae34607acab6b84a14672a455d8a179c28eb603 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 88109203c1..95a8dfd4c1 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