Skip to content

Commit bdef930

Browse files
authored
Update enum.rst
- Correct typos. - Make comments more precise.
1 parent a95ee3a commit bdef930

File tree

1 file changed

+9
-9
lines changed

1 file changed

+9
-9
lines changed

Doc/library/enum.rst

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -240,7 +240,7 @@ Data types
240240

241241
.. method:: EnumType.__len__(cls)
242242

243-
Returns the number of member in *cls*::
243+
Returns the number of members in *cls*::
244244

245245
>>> len(Color)
246246
3
@@ -502,7 +502,7 @@ Data types
502502
Using :class:`auto` with :class:`Enum` results in integers of increasing value,
503503
starting with ``1``.
504504

505-
.. versionchanged:: 3.12 Added :ref:`enum-dataclass-support`
505+
.. versionchanged:: 3.12 Added :ref:`enum-dataclass-support`.
506506

507507
.. method:: Enum._add_alias_
508508

@@ -977,9 +977,9 @@ Utilities and decorators
977977

978978
*auto* can be used in place of a value. If used, the *Enum* machinery will
979979
call an :class:`Enum`'s :meth:`~Enum._generate_next_value_` to get an appropriate value.
980-
For :class:`Enum` and :class:`IntEnum` that appropriate value will be the last value plus
981-
one; for :class:`Flag` and :class:`IntFlag` it will be the first power-of-two greater
982-
than the highest value; for :class:`StrEnum` it will be the lower-cased version of
980+
For :class:`Enum` and :class:`IntEnum` that appropriate value will be the highest value seen
981+
plus one; for :class:`Flag` and :class:`IntFlag` it will be the first power-of-two greater
982+
than the highest value seen; for :class:`StrEnum` it will be the lower-cased version of
983983
the member's name. Care must be taken if mixing *auto()* with manually
984984
specified values.
985985

@@ -989,8 +989,8 @@ Utilities and decorators
989989
* ``FIRST = auto()`` will work (auto() is replaced with ``1``);
990990
* ``SECOND = auto(), -2`` will work (auto is replaced with ``2``, so ``2, -2`` is
991991
used to create the ``SECOND`` enum member;
992-
* ``THREE = [auto(), -3]`` will *not* work (``[<auto instance>, -3]`` is used to
993-
create the ``THREE`` enum member)
992+
* ``THIRD = [auto(), -3]`` will *not* work (``[<auto instance>, -3]`` is used to
993+
create the ``THIRD`` enum member)
994994

995995
.. versionchanged:: 3.11.1
996996

@@ -1000,7 +1000,7 @@ Utilities and decorators
10001000
``_generate_next_value_`` can be overridden to customize the values used by
10011001
*auto*.
10021002

1003-
.. note:: in 3.13 the default ``_generate_next_value_`` will always return
1003+
.. note:: In version 3.13 the default ``_generate_next_value_`` will always return
10041004
the highest member value incremented by 1, and will fail if any
10051005
member is an incompatible type.
10061006

@@ -1010,7 +1010,7 @@ Utilities and decorators
10101010
enumerations. It allows member attributes to have the same names as members
10111011
themselves.
10121012

1013-
.. note:: the *property* and the member must be defined in separate classes;
1013+
.. note:: The *property* and the member must be defined in separate classes;
10141014
for example, the *value* and *name* attributes are defined in the
10151015
*Enum* class, and *Enum* subclasses can define members with the
10161016
names ``value`` and ``name``.

0 commit comments

Comments
 (0)