From: Ondřej Surý <ondrej@isc.org>
Date: Thu, 28 Aug 2025 09:40:37 +0000 (+0200)
Subject: Clarify rrset-order random distribution
X-Git-Tag: v9.21.12~4^2
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=369c8dc388caad0d4fa7e9da15a3a0cd62cd3b39;p=thirdparty%2Fbind9.git

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.
---

diff --git a/doc/arm/reference.rst b/doc/arm/reference.rst
index f79eb595208..b41429d1d41 100644
--- a/doc/arm/reference.rst
+++ b/doc/arm/reference.rst
@@ -4050,7 +4050,8 @@ RRset Ordering
    The legal values for ``<ordering>`` are:
 
    ``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