From: Otto Moerbeek Date: Mon, 6 Nov 2023 12:51:54 +0000 (+0100) Subject: rec: describe the YAML transition plan in three phases X-Git-Tag: rec-5.0.0-rc1~21^2~1 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=05ee09299b3bda752811321300a21219363bf13b;p=thirdparty%2Fpdns.git rec: describe the YAML transition plan in three phases --- diff --git a/pdns/recursordist/settings/docs-new-preamble-in.rst b/pdns/recursordist/settings/docs-new-preamble-in.rst index e59cb5d1db..f5aa1a9016 100644 --- a/pdns/recursordist/settings/docs-new-preamble-in.rst +++ b/pdns/recursordist/settings/docs-new-preamble-in.rst @@ -5,10 +5,19 @@ Each setting can appear on the command line, prefixed by ``--`` and using the ol Settings on the command line are processed after the file-based settings are processed. .. note:: - Starting with version 5.0.0., :program:`Recursor` supports a new YAML syntax for configuration files + Starting with version 5.0.0, :program:`Recursor` supports a new YAML syntax for configuration files as described here. + 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`. - In a future release support for the "old-style" settings will be dropped. + + Release 5.0.0 will install a default old-style ``recursor.conf`` files only. + + 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. + + 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. + + In a future release support for the "old-style" ``recursor.conf`` settings file will be dropped. YAML settings file