Tweak and reword release notes

diff --git a/doc/notes/notes-current.rst b/doc/notes/notes-current.rst
index 5471c38509cbf62e898752440178cda563ee1b4e..e029127c60dcace56b0c7036cef95f57d838866b 100644 (file)
--- a/doc/notes/notes-current.rst
+++ b/doc/notes/notes-current.rst
@@ -27,9 +27,9 @@ New Features
 - Add a new ``rndc`` command, ``rndc dnssec -rollover``, which triggers
   a manual rollover for a specific key. [GL #1749]
 
-- New ``rndc`` command ``rndc dumpdb -expired`` that dumps the cache database
-  to the dump-file including expired RRsets that are awaiting cleanup, for
-  diagnostic purposes. [GL #1870]
+- Add a new ``rndc`` command, ``rndc dumpdb -expired``, which dumps the
+  cache database, including expired RRsets that are awaiting cleanup, to
+  the ``dump-file`` for diagnostic purposes. [GL #1870]
 
 Removed Features
 ~~~~~~~~~~~~~~~~
@@ -40,15 +40,16 @@ Removed Features
 Feature Changes
 ~~~~~~~~~~~~~~~
 
-- [DNS Flag Day 2020]: The default EDNS buffer size has been changed from 4096
-  to 1232.  According to the measurements done by multiple parties this should
-  not be causing any operational problems as most of the Internet "core" is able
-  to cope with IP message sizes between 1400-1500 bytes, the 1232 size was
-  picked as a conservative minimal number that could be changed by the DNS
-  operator to a estimated path MTU minus the estimated header space. In
-  practice, the smallest MTU witnessed in the operational DNS community is 1500
-  octets, the Ethernet maximum payload size, so a a useful default for maximum
-  DNS/UDP payload size on reliable networks would be 1400. [GL #2183]
+- DNS Flag Day 2020: The default EDNS buffer size has been changed from
+  4096 to 1232 bytes. According to measurements done by multiple
+  parties, this should not cause any operational problems as most of the
+  Internet "core" is able to cope with IP message sizes between
+  1400-1500 bytes; the 1232 size was picked as a conservative minimal
+  number that could be changed by the DNS operator to an estimated path
+  MTU minus the estimated header space. In practice, the smallest MTU
+  witnessed in the operational DNS community is 1500 octets, the maximum
+  Ethernet payload size, so a useful default for maximum DNS/UDP payload
+  size on reliable networks would be 1400 bytes. [GL #2183]
 
 Bug Fixes
 ~~~~~~~~~
@@ -57,16 +58,17 @@ Bug Fixes
   varying letter case could cause some processing rules in that RPZ zone
   to be erroneously ignored. [GL #2169]
 
-- `named` would report invalid memory size when running in an environment
-  that doesn't properly report number of available memory pages or pagesize.
-  [GL #2166]
+- ``named`` reported an invalid memory size when running in an
+  environment that did not properly report the number of available
+  memory pages and/or the size of each memory page. [GL #2166]
 
-- `named` would exit with assertion failure REQUIRE(msg->state == (-1)) in
-  message.c due to a possible data race. [GL #2124]
+- With multiple forwarders configured, ``named`` could fail the
+  ``REQUIRE(msg->state == (-1))`` assertion in ``lib/dns/message.c``,
+  causing it to crash. This has been fixed. [GL #2124]
 
-- `named` would start continous rollovers for policies that algorithms
-  Ed25519 or Ed448 due to a mismatch in created key size and expected key size.
-  [GL #2171]
+- ``named`` erroneously performed continuous key rollovers for KASP
+  policies that used algorithm Ed25519 or Ed448 due to a mismatch
+  between created key size and expected key size. [GL #2171]
 
 - Handle `UV_EOF` differently such that it is not treated as a `TCP4RecvErr` or
   `TCP6RecvErr`. [GL #2208]