Tweak and reword release notes

diff --git a/doc/notes/notes-9.16.5.rst b/doc/notes/notes-9.16.5.rst
index c0a0ce308d57f07ee263d6030dfcce3d29673698..87a619b3411d8b9741a00b323e9f253a13680cbd 100644 (file)
--- a/doc/notes/notes-9.16.5.rst
+++ b/doc/notes/notes-9.16.5.rst
@@ -11,45 +11,45 @@
 Notes for BIND 9.16.5
 ---------------------
 
-Feature Changes
-~~~~~~~~~~~~~~~
+New Features
+~~~~~~~~~~~~
 
-- New ``rndc`` command ``rndc dnssec -status`` that shows the current
-  DNSSEC policy and keys in use, the key states and rollover status.
+- New ``rndc`` command ``rndc dnssec -status`` shows the current DNSSEC
+  policy and keys in use, the key states, and rollover status.
   [GL #1612]
 
 Bug Fixes
 ~~~~~~~~~
 
-- The DS set returned by ``dns_keynode_dsset()`` was not thread-safe.
-  This could result in an INSIST being triggered. [GL #1926]
+- The DS RRset returned by ``dns_keynode_dsset()`` was used in a
+  non-thread-safe manner. This could result in an INSIST being
+  triggered. [GL #1926]
 
 - Properly handle missing ``kyua`` command so that ``make check`` does
   not fail unexpectedly when CMocka is installed, but Kyua is not.
   [GL #1950]
 
-- The ``primary`` and ``secondary`` keywords, when used as parameters for
-  ``check-names``, were not processed correctly and were being ignored.
-  [GL #1949]
+- The ``primary`` and ``secondary`` keywords, when used as parameters
+  for ``check-names``, were not processed correctly and were being
+  ignored. [GL #1949]
 
-- 'rndc dnstap -roll <value>' was not limiting the number of saved
-  files to <value>. [GL !3728]
+- ``rndc dnstap -roll <value>`` did not limit the number of saved files
+  to ``<value>``. [GL !3728]
 
 - The validator could fail to accept a properly signed RRset if an
   unsupported algorithm appeared earlier in the DNSKEY RRset than a
-  supported algorithm.  It could also stop if it detected a malformed
+  supported algorithm. It could also stop if it detected a malformed
   public key. [GL #1689]
 
-- The ``blackhole`` ACL was inadvertently disabled with respect to
-  client queries. Blocked IP addresses were not used for upstream
-  queries but queries from those addresses could still be answered.
-  [GL #1936]
+- The ``blackhole`` ACL was inadvertently disabled for client queries.
+  Blocked IP addresses were not used for upstream queries but queries
+  from those addresses could still be answered. [GL #1936]
 
-- ``named`` would crash on shutdown when new ``rndc`` connection is received at
-  the same time as shutting down. [GL #1747]
+- ``named`` crashed on shutdown when a new ``rndc`` connection was
+  received during shutdown. This has been fixed. [GL #1747]
 
-- Fix assertion failure when server is under load and root zone is not yet
-  loaded. [GL #1862]
+- Fix assertion failure when server was under load and root zone had not
+  yet been loaded. [GL #1862]
 
-- ``named`` could crash when cleaning dead nodes in ``lib/dns/rbtdb.c`` that
-  have been reused meanwhile.  [GL #1968]
+- ``named`` could crash when cleaning dead nodes in ``lib/dns/rbtdb.c``
+  that were being reused. [GL #1968]