Text edits to Statements and Statements by Tag sections

(cherry picked from commit d4b93c4bd6eebaaafe3c40f43671113c5543f645)

diff --git a/doc/arm/reference.rst b/doc/arm/reference.rst
index 8f29e55c5ee5592ee59534f1cbb11472fea491f3..54ef36e15b1c893269f789b6bff7583bd9240f22 100644 (file)
--- a/doc/arm/reference.rst
+++ b/doc/arm/reference.rst
@@ -7635,21 +7635,23 @@ An :any:`in-view` zone is not intended to reference a :any:`forward` zone.
 
 Statements
 ----------
-The following table lists all statements permissible in :file:`named.conf`. Please note
-that this section is a work in progress.
-
-.. namedconf:statementlist::
-
-Statements by Tag
------------------
-
 BIND 9 supports many hundreds of statements; finding the right statement to
 control a specific behavior or solve a particular problem can be a daunting
-task. To simplify the task all statements have been assigned one or more tags.
+task. To simplify the task for users, all statements have been assigned one or more tags.
 Tags are designed to group together statements that have broadly similar
 functionality; thus, for example, all statements that control the handling of
 queries or of zone transfers are respectively tagged under **query** and **transfer**.
 
+The following table lists all statements permissible in :file:`named.conf`; the next
+section groups the statements by tag. Please note that these sections are a work in progress.
+
+.. namedconf:statementlist::
+
+Statements by Tag
+-----------------
+These tables group the various statements permissible in :file:`named.conf` by
+their corresponding tag.
+
 DNSSEC Tag Statements
 ~~~~~~~~~~~~~~~~~~~~~
 .. namedconf:statementlist::