- More specific wording in the unbound.conf man page for stub-first

  and forward-first options.

diff --git a/doc/Changelog b/doc/Changelog
index 704424cf74783898b008dcfdcac99bc52da2ca15..7ea887303b2ceeddb3d0c7971ba5ac04e18ee22a 100644 (file)
--- a/doc/Changelog
+++ b/doc/Changelog
@@ -1,3 +1,7 @@
+24 December 2025: Yorgos
+       - More specific wording in the unbound.conf man page for stub-first
+         and forward-first options.
+
 3 December 2025: Wouter
        - Fix http2 drop handling to clear the postpone_drop state so that
          other streams on the http2 session are not affected by a drop,

diff --git a/doc/unbound.conf.rst b/doc/unbound.conf.rst
index 8f78fb31d60ce1bdc596e4144356d61587355799..da3a8b73c12952fc1fad42138dc03fdcc7163958 100644 (file)
--- a/doc/unbound.conf.rst
+++ b/doc/unbound.conf.rst
@@ -3587,6 +3587,9 @@ The :ref:`local-zone: nodefault<unbound.conf.local-zone.type.nodefault>` (or
     If enabled, a query is attempted without this stub section if it fails.
     The data could not be retrieved and would have caused SERVFAIL because the
     servers are unreachable, instead it is tried without this stub section.
+    This can lead to using less specific configured forward/stub/auth zones if
+    any, or end up to otherwise normal recursive resolution for that particular
+    query.
 
     Default: no
 
@@ -3699,9 +3702,11 @@ cache).
 
 
 @@UAHL@unbound.conf.forward@forward-first@@: *<yes or no>*
-    If a forwarded query is met with a SERVFAIL error, and this option is
-    enabled, Unbound will fall back to normal recursive resolution for this
-    query as if no query forwarding had been specified.
+    If a forwarded query is met with a SERVFAIL error and this option is
+    enabled Unbound will fall back to less specific resolution.
+    This can lead to using less specific configured forward/stub/auth zones if
+    any, or end up to otherwise normal recursive resolution for that particular
+    query.
 
     Default: no