Tweak and reword release notes

diff --git a/doc/notes/notes-9.20.16.rst b/doc/notes/notes-9.20.16.rst
index 17bb16c8c4b00a8315c46de5f58d94cecae3f147..88f24ecff63871576dabcacc00a77acbf44feaa9 100644 (file)
--- a/doc/notes/notes-9.20.16.rst
+++ b/doc/notes/notes-9.20.16.rst
@@ -15,44 +15,44 @@ Notes for BIND 9.20.16
 Bug Fixes
 ~~~~~~~~~
 
-- Fix dnssec-keygen key collision checking for KEY rrtype keys.
+- Fix :iscman:`dnssec-keygen` key collision checking for KEY RRtype
+  keys.
 
   The :iscman:`dnssec-keygen` utility program failed to detect possible
-  Key ID collisions with the existing keys generated using the
-  non-default ``-T KEY`` option (e.g. for ``SIG(0)``). This has been
-  fixed. :gl:`#5506`
+  KEY ID collisions with existing keys generated using the non-default
+  ``-T KEY`` option (e.g., for ``SIG(0)``). This has been fixed.
+  :gl:`#5506`
 
-- Fix shutdown INSIST in dns_dispatchmgr_getblackhole.
+- Fix shutdown assertion in ``dns_dispatchmgr_getblackhole``.
 
-  Previously, `named` could trigger an assertion in
-  `dns_dispatchmgr_getblackhole` while shutting down. This has been
+  Previously, :iscman:`named` could trigger an assertion in
+  ``dns_dispatchmgr_getblackhole`` while shutting down. This has been
   fixed. :gl:`#5525`
 
-- Dnssec-verify now uses exit code 1 when failing due to illegal
-  options.
+- :iscman:`dnssec-verify` now uses exit code 1 when failing due to
+  illegal options.
 
-  Previously, dnssec-verify exited with code 0 if the options could not
-  be parsed. This has been fixed. :gl:`#5574`
+  Previously, :iscman:`dnssec-verify` exited with code 0 if the options
+  could not be parsed. This has been fixed. :gl:`#5574`
 
-- Prevent assertion failures of dig when server is specified before the
-  -b option.
+- Prevent assertion failures of :iscman:`dig` when a server is specified
+  before the ``-b`` option.
 
   Previously, :iscman:`dig` could exit with an assertion failure when
-  the server was specified before the :option:`dig -b` option. This has
+  a server was specified before the :option:`dig -b` option. This has
   been fixed. :gl:`#5609`
 
-- Skip unsupported algorithms when looking for signing key.
+- Skip unsupported algorithms when looking for a signing key.
 
   A mix of supported and unsupported DNSSEC algorithms in the same zone
-  could have caused validation failures. Ignore the DNSSEC keys with
-  unsupported algorithm when looking for the signing keys. :gl:`#5622`
+  could cause validation failures. Unsupported algorithms are now
+  ignored when looking for signing keys. :gl:`#5622`
 
 - Skip buffer allocations if not logging.
 
-  Currently, during IXFR we allocate a 2KB buffer for IXFR change
-  logging regardless of the log level. This commit introduces an early
-  check on the log level in dns_diff_print to avoid this.
+  Previously, we allocated a 2KB buffer for IXFR change logging,
+  regardless of the log level.
 
-  Results in a speedup from 28% in the test case from issue #5442.
+  This results in a 28% speedup in some scenarios.