From 8f3cc0ea141a1900e48761d642d07c24aa9192ca Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Petr=20=C5=A0pa=C4=8Dek?= <petr.spacek@nic.cz>
Date: Wed, 4 Dec 2019 09:39:45 +0100
Subject: [PATCH] doc: clarify upgrade instructions for modules

---
 doc/upgrading.rst | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/doc/upgrading.rst b/doc/upgrading.rst
index c428b408f..ab5601606 100644
--- a/doc/upgrading.rst
+++ b/doc/upgrading.rst
@@ -11,9 +11,11 @@ We advise users to also read :ref:`release_notes` for respective versions.
 Module changes
 --------------
 
-* In case you directly call ``kr_ranked_rrarray_add()`` from your own module,
-  you need to additionally call ``kr_ranked_rrarray_finalize()`` after each batch
-  (before changing the added memory regions).
+* In case you wrote your own module which directly calls function
+  ``kr_ranked_rrarray_add()``, you need to additionally call function
+  ``kr_ranked_rrarray_finalize()`` after each batch (before changing
+  the added memory regions). For a specific example see `changes in dns64 module
+  <https://gitlab.labs.nic.cz/knot/knot-resolver/commit/edb8ffef7fbe48befeb3f7164d38079dd0be3302#1fe36e8ac0729b279645f7237b7122b1c457a982>`_.
 
 .. _upgrade-from-3-to-4:
 
-- 
GitLab