Apply suggestions from code review

Co-authored-by: Alex Waygood <[email protected]>

Author: ethanfurman

Doc/howto/enum.rst

@@ -972,8 +972,6 @@ Supported ``_sunder_`` names
 - :attr:`~Enum._ignore_` -- a list of names, either as a :class:`list` or a
   :class:`str`, that will not be transformed into members, and will be removed
   from the final class
-- :attr:`~Enum._order_` -- used in Python 2/3 code to ensure member order is
-  consistent (class attribute, removed during class creation)
 - :meth:`~Enum._generate_next_value_` -- used to get an appropriate value for
   an enum member; may be overridden
 

Doc/library/enum.rst

@@ -235,7 +235,7 @@ Data Types
         >>> len(Color)
         3
 
-   .. attribute: EnumType.__members__
+   .. attribute:: EnumType.__members__
 
       Returns a mapping of every enum name to its member, including aliases
 
@@ -246,12 +246,12 @@ Data Types
         >>> list(reversed(Color))
         [<Color.BLUE: 3>, <Color.GREEN: 2>, <Color.RED: 1>]
 
-   .. method: EnumType._add_alias_
+   .. method:: EnumType._add_alias_
 
       Adds a new name as an alias to an existing member.  Raises a
       :exc:`NameError` if the name is already assigned to a different member.
 
-   .. method: EnumType._add_value_alias_
+   .. method:: EnumType._add_value_alias_
 
       Adds a new value as an alias to an existing member.  Raises a
       :exc:`ValueError` if the value is already linked with a different member.

Lib/enum.py

@@ -334,7 +334,7 @@ class EnumDict(dict):
     """
     def __init__(self):
         super().__init__()
-        self._member_names = {} # use a dict -- faster look-up than a list, and keeps insertion order since 3.7 (?)
+        self._member_names = {} # use a dict -- faster look-up than a list, and keeps insertion order since 3.7
         self._last_values = []
         self._ignore = []
         self._auto_called = False