doc: move reorder_RR() into policy/acl/data manipulation section

diff --git a/daemon/README.rst b/daemon/README.rst
index 6194e06921fde139050b51d1655dbce376242627..59f76755e19ae545f397d925d17d87b386d72b47 100644 (file)
--- a/daemon/README.rst
+++ b/daemon/README.rst
@@ -34,15 +34,6 @@ TODO: Basics
       Operation not permitted
 
 
-.. function:: reorder_RR([true | false])
-
-   :param boolean value: New value for the option *(optional)*
-   :return: The (new) value of the option
-
-   If set, resolver will vary the order of resource records within RR-sets.
-   It is disabled by default.
-
-
 .. _`JSON-encoded`: http://json.org/example
 .. _`Learn Lua in 15 minutes`: http://tylerneylon.com/a/learn-lua/
 .. _`PowerDNS Recursor`: https://doc.powerdns.com/md/recursor/scripting/

diff --git a/doc/config.rst b/doc/config.rst
index 2bb771e3bec83c5a6961d2b1b83cee5b9b076bcd..399f28c0e287abdaf60896078a306262163919df 100644 (file)
--- a/doc/config.rst
+++ b/doc/config.rst
@@ -201,6 +201,12 @@ More fine-grained tools are available in following modules:
 
 Policy, access control, data manipulation
 =========================================
+Features in this section allow to configure what clients can get access to what DNS data, i.e. DNS data filtering and manipulation.
+
+.. contents::
+   :depth: 1
+   :local:
+
 .. include:: ../modules/hints/README.rst
 .. include:: ../modules/stats/README.rst
 .. include:: ../modules/policy/README.rst
@@ -210,6 +216,22 @@ Policy, access control, data manipulation
 .. include:: ../modules/dns64/README.rst
 .. include:: ../modules/renumber/README.rst
 
+Answer reordering
+-----------------
+Certain clients are "dumb" and always connect to first IP address or name found
+in a DNS answer received from resolver intead of picking randomly.
+As a workaround for such broken clients it is possible to randomize
+order of records in DNS answers sent by resolver:
+
+.. function:: reorder_RR([true | false])
+
+   :param boolean new_value: ``true`` to enable or ``false`` to disable randomization *(optional)*
+   :return: The (new) value of the option
+
+   If set, resolver will vary the order of resource records within RR sets.
+   It is disabled by default.
+
+
 
 Performance and resiliency
 ==========================