News/changed settings for 4.4.x upgrade guide.

diff --git a/pdns/recursordist/docs/settings.rst b/pdns/recursordist/docs/settings.rst
index d82c616988a284d07b14a0f22e0b7fbf6dfa6a7d..202472ce26885773b59b4ac3ea112be8c850dd32 100644 (file)
--- a/pdns/recursordist/docs/settings.rst
+++ b/pdns/recursordist/docs/settings.rst
@@ -1357,7 +1357,7 @@ Disabled by default, which also disables outgoing IPv6 support.
 
 Don't log queries.
 
-.. _setting-record-cache-shards
+.. _setting-record-cache-shards:
 
 ``record-cache-shards``
 ------------------------

diff --git a/pdns/recursordist/docs/upgrade.rst b/pdns/recursordist/docs/upgrade.rst
index 7ea9588fe79b3b5331c1327890f9ce90e6295693..f9a4a1b69a517f0586fd188b7645b10a9930778e 100644 (file)
--- a/pdns/recursordist/docs/upgrade.rst
+++ b/pdns/recursordist/docs/upgrade.rst
@@ -4,7 +4,21 @@ Upgrade Guide
 Before upgrading, it is advised to read the :doc:`changelog/index`.
 When upgrading several versions, please read **all** notes applying to the upgrade.
 
-4.2.x to 4.3.0 or master
+4.3.x to 4.4.0 or master
+------------------------
+
+Deprecated and changed settings
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+- The :ref:`setting-query-local-address` setting has been modified to be able to include both IPv4 and IPv6 addresses.
+- The :ref:`setting-query-local-address6` settings is now deprecated.
+
+New settings
+^^^^^^^^^^^^
+- The :ref:`setting-dns64-prefix` setting has been added, enabling common cases of DNS64 handling without having to write Lua code.
+- The :ref:`setting-proxy-protocol-from` and :ref:`setting-proxy-protocol-maximum-size` settings have been added to allow for passing of Proxy Protocol Version 2 headers between a client and the recursor.
+- The :ref:`setting-record-cache-shards` setting has been added, enabling the administrator to change the number of shards in the records cache. The value of the metric ``record-cache-contended`` divided by ``record-cache-acquired`` indicates if the record cache locks are contended. If so, increasing the number of shards can help reducing the contention.
+
+4.2.x to 4.3.0
 ------------------------
 
 Lua Netmask class methods changed