From: Suzanne Goldlust <sgoldlust@isc.org>
Date: Tue, 2 Apr 2024 15:26:16 +0000 (+0000)
Subject: Tweak and reword release notes
X-Git-Tag: v9.19.23~2^2
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=4c0db2ee3c0040a165f6a9b13a19cb215a40c8fe;p=thirdparty%2Fbind9.git

Tweak and reword release notes
---

diff --git a/doc/notes/notes-9.19.23.rst b/doc/notes/notes-9.19.23.rst
index 1fd661fdd38..08fe30d5514 100644
--- a/doc/notes/notes-9.19.23.rst
+++ b/doc/notes/notes-9.19.23.rst
@@ -20,27 +20,29 @@ New Features
 Feature Changes
 ~~~~~~~~~~~~~~~
 
-- Memory consumption of the new QP-trie database has been optimized and
-  large zones now require roughly 15 % more memory than the old red-black tree
-  data structure. :gl:`#4614`
+- Memory consumption of the new QP-trie database has been optimized. Large
+  zones, which used to require significantly more memory with QP-trie, now only
+  require roughly 15% more memory than the old red-black tree data structure.
+  :gl:`#4614`
 
-- The ``sortlist`` option has been deprecated and will be removed
-  in a future BIND 9.21.x release. Please don't rely on a specific
-  order of resource records in the DNS messages.  :gl:`#4593`
+- The :any:`sortlist` option has been deprecated and will be removed in a
+  future BIND 9.21.x release. Users should not rely on a specific order of
+  resource records in DNS messages.  :gl:`#4593`
+
+- The ``fixed`` value for the :any:`rrset-order` option and the corresponding
+  ``configure`` script option have been deprecated and will be removed in a
+  future BIND 9.21.x release. Users should not rely on a specific order of
+  resource records in DNS messages.  :gl:`#4446`
 
-- The ``fixed`` value for the ``rrset-order`` option and the corresponding
-  ``./configure`` script option has been deprecated and will be removed in a
-  future BIND 9.21.x release. Please don't rely on a specific order of resource
-  records in the DNS messages.  :gl:`#4446`
 
 Bug Fixes
 ~~~~~~~~~
 
-- Some DNSSEC key rollovers were slowed down erroneously. This has been fixed.
-  :gl:`#4552`
+- A bug in the keymgr code unintentionally slowed down some DNSSEC key
+  rollovers. This has been fixed. :gl:`#4552`
 
-- Bugs which could cause resolvers configured with the new cache data structure
-  to crash or hang have been fixed. :gl:`#4622` :gl:`#4652`
+- Two bugs that could have caused resolvers configured with the new cache data
+  structure to crash or hang have been fixed. :gl:`#4622` :gl:`#4652`
 
 - Some ISO 8601 durations were accepted erroneously, leading to shorter
   durations than expected. This has been fixed. :gl:`#4624`