Clarify rrset-order random distribution

The randomized order of the records in the rrset is not uniform across
all permutations.  Clarify this in the documentation.

(cherry picked from commit 369c8dc388caad0d4fa7e9da15a3a0cd62cd3b39)

diff --git a/doc/arm/reference.rst b/doc/arm/reference.rst
index 0c3776d08305256416261babc820a07914ae9362..2b89c45abc9c0c0494d45e0c9a2dda0785bc0553 100644 (file)
--- a/doc/arm/reference.rst
+++ b/doc/arm/reference.rst
@@ -4269,7 +4269,8 @@ RRset Ordering
        ``--enable-fixed-rrset`` at compile time.
 
    ``random``
-       Records are returned in a random order.
+       Records are returned in a non-deterministic order.  The random ordering
+       doesn't guarantee uniform distribution of all permutations.
 
    ``cyclic``
        Records are returned in a cyclic round-robin order, rotating by one