Bug#1111009: release-notes: Make users aware of change of configuration file syntax for package pdns-recursor

[Roel Schroeven <roel@roelschroeven.net>]

Package: release-notes
Severity: important

The version of pdns-recursor in trixie uses a different configuration
file syntax as compared to the version in bookworm. By default the new
version doesn't support the old configuration syntax anymore, and
therefore fails to work correctly.

There is a tool to help with this (rec_control show-yaml), but it only
works when pdns-recursor is working correctly. There is a workaround:
you can give command line option '--enable-old-settings' to
pdns-recursor, which will enable support for the old configuration file
format. I don't know the best way to supply this command line option. I
did it by temporarily creating a custom systemd service configuration
file and adding the switch to the ExecStart entry.

In any case, I think it would be best to mention this in the "Issues to
be aware of for trixie" chapter of the release notes for trixie. Maybe
use the text from apt-listchanges:

    The configuration file syntax has changed from the old key=value
    format to YAML. You must manually migrate, otherwise the service
    fails to (re-)start.

    See the documentation on how to migrate:
    https://doc.powerdns.com/recursor/yamlsettings.html

Maybe contact the pdns-recursor maintainer for the best procedure on how
to handle the configuration file syntax conversion.