Document the new approach of reading YAML from a recursor.conf file

diff --git a/pdns/recursordist/settings/docs-new-preamble-in.rst b/pdns/recursordist/settings/docs-new-preamble-in.rst
index 6aaba02b3a105334b1ac921a35e87d5101df56a0..ffee47e6d4a28decc8344a9c9ffea09ca5c128a7 100644 (file)
--- a/pdns/recursordist/settings/docs-new-preamble-in.rst
+++ b/pdns/recursordist/settings/docs-new-preamble-in.rst
@@ -10,12 +10,13 @@ Settings on the command line are processed after the file-based settings are pro
    If both ``recursor.conf`` and ``recursor.yml`` files are found in the configuration directory the YAML file is used.
    A configuration using the old style syntax can be converted to a YAML configuration using the instructions in :doc:`appendices/yamlconversion`.
 
-   Release 5.0.0 will install a default old-style ``recursor.conf`` files only.
+   Release 5.0.0 will install a default old-style ``recursor.conf`` file.
 
-   With the release of version 5.1.0, packages will stop installing a default ``recursor.conf`` and start installing a default ``recursor.yml`` file if no existing ``recursor.conf`` is present.
-   In the absense of a ``recursor.yml`` file, an existing ``recursor.conf`` file will be accepted and used.
+   Starting with version 5.1.0, in the absense of a ``recursor.yml`` file, an existing ``recursor.conf`` will be processed as YAML,
+   if that fails, it will be processed as old-style configuration.
+   Packages will stop installing a old-style ``recursor.conf`` file and start installing a default ``recursor.conf`` file containing YAML syntax.
 
-   With the release of 5.2.0, the default will be to expect a ``recursor.yml`` file and reading of ``recursor.conf`` files will have to be enabled specifically by providing a command line option.
+   With the release of 5.2.0, the default will be to expect a YAML configuation file and reading of old-style ``recursor.conf`` files will have to be enabled specifically by providing a command line option.
 
    In a future release support for the "old-style" ``recursor.conf`` settings file will be dropped.