From 0dbf9d03ba91c4a7bf3b3297682b3a47f5d57539 Mon Sep 17 00:00:00 2001 From: Matt Nordhoff Date: Wed, 12 May 2021 08:07:01 +0000 Subject: [PATCH] Combine duplicate sections in Recursor upgrade guide. Also use more consistent capitalization and wording. --- pdns/recursordist/docs/upgrade.rst | 15 ++++++--------- 1 file changed, 6 insertions(+), 9 deletions(-) diff --git a/pdns/recursordist/docs/upgrade.rst b/pdns/recursordist/docs/upgrade.rst index 3bf167dc7e..7bc05e4a1a 100644 --- a/pdns/recursordist/docs/upgrade.rst +++ b/pdns/recursordist/docs/upgrade.rst @@ -26,7 +26,7 @@ The next release will start deprecating them. Users are advised to start using the new names to avoid future trouble. -Special Domains +Special domains ^^^^^^^^^^^^^^^ Queries for all names in the ``.localhost`` domain will answer in accordance with :rfc:`6761` section 6.3 point 4. That means that they will be answered with ``127.0.0.1``, ``::1`` or a negative response. @@ -38,15 +38,16 @@ A single minus *-* can be used as a filename to write the data to the standard o Additionally, a single minus *-* can be used as a filename to write the data to the standard output stream. Previously the file was opened by the recursor, possibly in its chroot environment. -New Settings +New settings ^^^^^^^^^^^^ -- The :ref:`setting-extended-resolution-errors` has been added, enabling adding EDNS Extended Errors to responses. -- The :ref:`setting-refresh-on-ttl-perc`, enabling an automatic cache-refresh mechanism. +- The :ref:`setting-extended-resolution-errors` setting has been added, enabling adding EDNS Extended Errors to responses. +- The :ref:`setting-refresh-on-ttl-perc` setting has been added, enabling an automatic cache-refresh mechanism. - The :ref:`setting-ecs-ipv4-never-cache` and :ref:`setting-ecs-ipv6-never-cache` settings have been added, allowing an overrule of the existing decision whether to cache EDNS responses carrying subnet information. - The :ref:`setting-aggressive-nsec-cache-size` setting has been added, enabling the functionality described in :rfc:`8198`. - The :ref:`setting-x-dnssec-names` setting has been added, allowing DNSSEC metrics to be recorded in a different set of counter for given domains. - The :ref:`setting-non-resolving-ns-max-fails` and :ref:`setting-non-resolving-ns-throttle-time` settings have been added, allowing the control of the cache of nameservers failing to resolve. - The :ref:`setting-edns-padding-from` and :ref:`setting-edns-padding-mode` and :ref:`setting-edns-padding-tag` settings have been added, to control how padding is applied to answers sent to clients. +- The :ref:`setting-tcp-fast-open-connect` setting has been added, it enables TCP Fast Connect for outgoing connections. Please read :ref:`tcp-fast-open-support` before enabling this feature. Deprecated and changed settings ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ @@ -61,10 +62,6 @@ Removed settings ^^^^^^^^^^^^^^^^ - The :ref:`setting-query-local-address6` has been removed. It already was deprecated. -New settings -^^^^^^^^^^^^ -- A new setting :ref:`setting-tcp-fast-open-connect` has been introduced, it enables TCP Fast Connect for outgoing connections. Please read :ref:`tcp-fast-open-support` before enabling this feature. - 4.3.x to 4.4.0 -------------- @@ -131,7 +128,7 @@ New settings - The :ref:`setting-max-generate-steps` setting has been added. This sets the maximum number of steps that will be performed when loading a BIND zone with the ``$GENERATE`` directive. The default is 0, which is unlimited. - The :ref:`setting-nothing-below-nxdomain` setting has been added. This setting controls the way cached NXDOMAIN replies imply non-existence of a whole subtree. The default is `dnssec` which means that only DNSSEC validated NXDOMAINS results are used. - The :ref:`setting-qname-minimization` setting has been added. This options controls if QName Minimization is used. The default is `yes`. - + 4.1.x to 4.2.0 -------------- -- 2.47.2