dnsdist: Better documentation for `DNSQuestion:restart()`

diff --git a/pdns/dnsdistdist/docs/reference/dq.rst b/pdns/dnsdistdist/docs/reference/dq.rst
index 02fc13f126cbc4365a225380d0115071316b69cd..410318c0ff7440af084db5cea78241db4ac52248 100644 (file)
--- a/pdns/dnsdistdist/docs/reference/dq.rst
+++ b/pdns/dnsdistdist/docs/reference/dq.rst
@@ -398,7 +398,8 @@ DNSResponse object
 
     .. versionadded:: 1.8.0
 
-    Discard the received response and restart the processing of the query, for example after selecting a different pool of servers:
+    Discard the received response and restart the processing of the query. For this function to be usable, the query should have been made restartable first, via :func:`DNSQuestion:setRestartable`.
+    For example, to restart the processing after selecting a different pool of servers:
 
     .. code-block:: Lua
 
@@ -421,8 +422,6 @@ DNSResponse object
       addAction(AllRule(), LuaAction(makeQueryRestartable))
       addResponseAction(AllRule(), LuaResponseAction(restartOnServFail))
 
-    For this function to be usable, the query should have been made restartable first, via :func:`DNSQuestion:setRestartable`.
-
 .. _DNSHeader:
 
 DNSHeader (``dh``) object