From 7842a0ca8f37af879b36abceafa7b206c739cc16 Mon Sep 17 00:00:00 2001
From: Ron Aitchison <ron@zytrax.com>
Date: Tue, 22 Mar 2022 01:11:02 +0000
Subject: [PATCH] Restructure includes for chapter 9 Troubleshooting

---
 doc/arm/Makefile.am                                 |  3 ++-
 doc/arm/chapter9.rst                                | 13 +++++++++++++
 doc/arm/index.rst                                   |  2 +-
 ...{troubleshooting.rst => troubleshooting.inc.rst} |  2 +-
 4 files changed, 17 insertions(+), 3 deletions(-)
 create mode 100644 doc/arm/chapter9.rst
 rename doc/arm/{troubleshooting.rst => troubleshooting.inc.rst} (99%)

diff --git a/doc/arm/Makefile.am b/doc/arm/Makefile.am
index fa09192a31..ba734687a5 100644
--- a/doc/arm/Makefile.am
+++ b/doc/arm/Makefile.am
@@ -13,6 +13,7 @@ EXTRA_DIST =					\
 	chapter5.rst				\
 	chapter6.rst				\
 	chapter7.rst				\
+	chapter9.rst				\
 	configuration.inc.rst			\
 	conf.py					\
 	dlz.inc.rst				\
@@ -50,7 +51,7 @@ EXTRA_DIST =					\
 	security.inc.rst			\
 	sig0.inc.rst				\
 	tkey.inc.rst				\
-	troubleshooting.rst			\
+	troubleshooting.inc.rst			\
 	tsig.inc.rst				\
 	../dnssec-guide				\
 	../misc/acl.grammar.rst			\
diff --git a/doc/arm/chapter9.rst b/doc/arm/chapter9.rst
new file mode 100644
index 0000000000..afe54e3dfe
--- /dev/null
+++ b/doc/arm/chapter9.rst
@@ -0,0 +1,13 @@
+.. Copyright (C) Internet Systems Consortium, Inc. ("ISC")
+..
+.. SPDX-License-Identifier: MPL-2.0
+..
+.. This Source Code Form is subject to the terms of the Mozilla Public
+.. License, v. 2.0.  If a copy of the MPL was not distributed with this
+.. file, you can obtain one at https://mozilla.org/MPL/2.0/.
+..
+.. See the COPYRIGHT file distributed with this work for additional
+.. information regarding copyright ownership.
+
+.. include:: troubleshooting.inc.rst
+
diff --git a/doc/arm/index.rst b/doc/arm/index.rst
index aeeefe1902..765a0dc40c 100644
--- a/doc/arm/index.rst
+++ b/doc/arm/index.rst
@@ -25,7 +25,7 @@ BIND 9 Administrator Reference Manual
    chapter6
    chapter7
    reference
-   troubleshooting
+   chapter9
    chapter10
 
 .. toctree::
diff --git a/doc/arm/troubleshooting.rst b/doc/arm/troubleshooting.inc.rst
similarity index 99%
rename from doc/arm/troubleshooting.rst
rename to doc/arm/troubleshooting.inc.rst
index 9b86fca1c4..ba1855eede 100644
--- a/doc/arm/troubleshooting.rst
+++ b/doc/arm/troubleshooting.inc.rst
@@ -9,7 +9,7 @@
 .. See the COPYRIGHT file distributed with this work for additional
 .. information regarding copyright ownership.
 
-.. Troubleshooting:
+.. _troubleshooting:
 
 Troubleshooting
 ===============