diff --git a/CHANGES b/CHANGES
index 335daf5b77..ae158e6068 100644
--- a/CHANGES
+++ b/CHANGES
@@ -1,3 +1,6 @@
+3985. [doc] Describe how +ndots and +search interact in dig.
+ [RT #37529]
+
3984. [func] Accept 256 byte long PINs in native PKCS#11
crypto. [RT #37410]
diff --git a/bin/dig/dig.docbook b/bin/dig/dig.docbook
index 2726f284e1..5dfbe212df 100644
--- a/bin/dig/dig.docbook
+++ b/bin/dig/dig.docbook
@@ -683,7 +683,8 @@
are interpreted as relative names and will be searched
for in the domains listed in the
or directive in
- /etc/resolv.conf.
+ /etc/resolv.conf if
+ is set.
@@ -790,6 +791,13 @@
resolv.conf (if any). The search
list is not used by default.
+
+ 'ndots' from resolv.conf (default 1)
+ which may be overridden by +ndots
+ determines if the name will be treated as relative
+ or not and hence whether a search is eventually
+ performed or not.
+