[3.12] gh-114211: Update EmailMessage doc about ordered keys (GH-114224) (#114225)

Ordered keys are no longer unlike 'real dict's.
(cherry picked from commit 8cda72037b262772399b2b7fc36dee9340d74fd6)

Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>

diff --git a/Doc/library/email.message.rst b/Doc/library/email.message.rst
index f58d93da6ed68711f5cf952492a2d998e9570b56..adea067e082615371c75bc89db4e10ddfa2ca10e 100644 (file)
--- a/Doc/library/email.message.rst
+++ b/Doc/library/email.message.rst
@@ -40,9 +40,9 @@ over the object tree.
 The :class:`EmailMessage` dictionary-like interface is indexed by the header
 names, which must be ASCII values.  The values of the dictionary are strings
 with some extra methods.  Headers are stored and returned in case-preserving
-form, but field names are matched case-insensitively.  Unlike a real dict,
-there is an ordering to the keys, and there can be duplicate keys.  Additional
-methods are provided for working with headers that have duplicate keys.
+form, but field names are matched case-insensitively.  The keys are ordered,
+but unlike a real dict, there can be duplicates.  Addtional methods are
+provided for working with headers that have duplicate keys.
 
 The *payload* is either a string or bytes object, in the case of simple message
 objects, or a list of :class:`EmailMessage` objects, for MIME container