From: Bob Halley <halley@dnspython.org>
Date: Mon, 4 Mar 2024 21:54:06 +0000 (-0800)
Subject: Update Set docstring [#1063].
X-Git-Tag: v2.7.0rc1~70
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=ff45c181d4db252be52feeafa034a099a57ca8e5;p=thirdparty%2Fdnspython.git

Update Set docstring [#1063].
---

diff --git a/dns/set.py b/dns/set.py
index 9081048a..04826e2e 100644
--- a/dns/set.py
+++ b/dns/set.py
@@ -21,10 +21,11 @@ import itertools
 class Set:
     """A simple set class.
 
-    This class was originally used to deal with sets being missing in
-    ancient versions of python, but dnspython will continue to use it
-    as these sets are based on lists and are thus indexable, and this
-    ability is widely used in dnspython applications.
+    This class was originally used to deal with python not having a set class, and
+    originally the class used lists in its implementation.  The ordered and indexable
+    nature of RRsets and Rdatasets is unfortunately widely used in dnspython
+    applications, so for backwards compatibility sets continue to be a custom class, now
+    based on an ordered dictionary.
     """
 
     __slots__ = ["items"]