From df818dee27a839480afc080aecc7f4f5e3d1482e Mon Sep 17 00:00:00 2001 From: =?utf8?q?Vladim=C3=ADr=20=C4=8Cun=C3=A1t?= Date: Wed, 26 Apr 2023 11:16:34 +0200 Subject: [PATCH] hints docs: explain root hints better The removed tip seemed especially misleading; I don't think our root hints could've ever been used that way. And latency to root servers has practically no impact on latency of replies to reasonable answers (just like... once per day and TLD). --- modules/hints/README.rst | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/modules/hints/README.rst b/modules/hints/README.rst index 97d24ddc6..c2deb5a93 100644 --- a/modules/hints/README.rst +++ b/modules/hints/README.rst @@ -8,8 +8,7 @@ Static hints This is a module providing static hints for forward records (A/AAAA) and reverse records (PTR). The records can be loaded from ``/etc/hosts``-like files and/or added directly. -You can also use the module to change the root hints; they are used as a safety belt or if the root NS -drops out of cache. +You can also use the module to change fallback addresses for the root servers. .. tip:: @@ -110,6 +109,9 @@ Properties Replace current root hints and return the current table of root hints. + These root hints are only used as fallback when addresses of ``NS .`` aren't available, + e.g. when cache is completely clear. + .. tip:: If no parameters are passed, it only returns current root hints set without changing anything. Example: @@ -127,8 +129,6 @@ Properties [1] => 202.12.27.33 } - .. tip:: A good rule of thumb is to select only a few fastest root hints. The server learns RTT and NS quality over time, and thus tries all servers available. You can help it by preselecting the candidates. - .. function:: hints.use_nodata(toggle) :param bool toggle: true if enabling NODATA synthesis, false if disabling -- 2.47.2