policy.DEBUG: NEWS + upgrading

diff --git a/NEWS b/NEWS
index d014a03a25af752c071ae62d807efc3415fd2570..450f8963372c4a95d92ac12fc4d207bbd311d28f 100644 (file)
--- a/NEWS
+++ b/NEWS
@@ -4,6 +4,7 @@ Knot Resolver 5.x.y (2020-0m-0d)
 Improvements
 ------------
 - cache garbage collector: reduce filesystem operations when idle (!946)
+- policy.DEBUG_ALWAYS and policy.DEBUG_IF for limited verbose logging (!957)
 
 Bugfixes
 --------
@@ -11,6 +12,11 @@ Bugfixes
 - lua: policy.rpz() no longer watches the file when watch is set to false (!954)
 - fix a strict aliasing problem that might've lead to "miscompilation" (!962)
 
+Incompatible changes
+--------------------
+- see upgrading guide: https://knot-resolver.readthedocs.io/en/stable/upgrading.html
+- minor changes in module API
+
 
 Knot Resolver 5.0.1 (2020-02-05)
 ================================

diff --git a/doc/upgrading.rst b/doc/upgrading.rst
index 541b0044cbced6d6e6ebe97292f7fdf26f2a6f17..487936273c88bb84ee01c1df3c1eefb102be25ad 100644 (file)
--- a/doc/upgrading.rst
+++ b/doc/upgrading.rst
@@ -8,6 +8,7 @@ Upgrading
 
 This section summarizes steps required for upgrade to newer Knot Resolver versions.
 We advise users to also read :ref:`release_notes` for respective versions.
+Section *Module changes* is relevant only for users who develop or use third-party modules.
 
 5.0 to 5.1
 ==========
@@ -15,7 +16,8 @@ We advise users to also read :ref:`release_notes` for respective versions.
 Module changes
 --------------
 
-* Custom modules which use :c:type:`trace_log_f` handler in request structure :c:type:`kr_request` need update to simplified handler API.
+* Modules which use :c:type:`kr_request::trace_log` handler in request structure :c:type:`kr_request` need update to modified handler API. Example migration is `modules/watchdog/watchdog.lua <https://gitlab.labs.nic.cz/knot/knot-resolver/-/merge_requests/957/diffs#6831501329bbf9e494048fe269c6b02944fc227c>`_.
+* Modules which were using logger :c:func:`kr_log_qverbose_impl` need migration to new logger :c:func:`kr_log_q`. Example migration is `modules/rebinding/rebinding.lua <https://gitlab.labs.nic.cz/knot/knot-resolver/-/merge_requests/957/diffs#6c74dcae147221ca64286a3ed028057adb6813b9>`_.
 
 
 4.x to 5.x