[Python-checkins] [3.9] bpo-42517: [ENUM] update docs for changes coming in 3.11 (GH-29113)

ethanfurman webhook-mailer at python.org
Wed Oct 20 19:11:51 EDT 2021


https://github.com/python/cpython/commit/9733c9651afad84ab2f010e9e68b7c03976ea9f3
commit: 9733c9651afad84ab2f010e9e68b7c03976ea9f3
branch: 3.9
author: Ethan Furman <ethan at stoneleaf.us>
committer: ethanfurman <ethan at stoneleaf.us>
date: 2021-10-20T16:11:47-07:00
summary:

[3.9] bpo-42517: [ENUM] update docs for changes coming in 3.11 (GH-29113)

files:
M Doc/library/enum.rst

diff --git a/Doc/library/enum.rst b/Doc/library/enum.rst
index bbe8bdc82b409..0b8ddc091fe15 100644
--- a/Doc/library/enum.rst
+++ b/Doc/library/enum.rst
@@ -1125,9 +1125,9 @@ and raise an error if the two do not match::
 _Private__names
 """""""""""""""
 
-Private names will be normal attributes in Python 3.10 instead of either an error
+Private names will be normal attributes in Python 3.11 instead of either an error
 or a member (depending on if the name ends with an underscore). Using these names
-in 3.9 will issue a :exc:`DeprecationWarning`.
+in 3.9 and 3.10 will issue a :exc:`DeprecationWarning`.
 
 
 ``Enum`` member type
@@ -1150,6 +1150,10 @@ all-uppercase names for members)::
     >>> FieldTypes.size.value
     2
 
+.. note::
+
+   This behavior is deprecated and will be removed in 3.11.
+
 .. versionchanged:: 3.5
 
 
@@ -1200,3 +1204,8 @@ all named flags and all named combinations of flags that are in the value::
     >>> Color(7)      # not named combination
     <Color.CYAN|MAGENTA|BLUE|YELLOW|GREEN|RED: 7>
 
+.. note::
+
+   In 3.11 unnamed combinations of flags will only produce the canonical flag
+   members (aka single-value flags).  So ``Color(7)`` would produce something
+   like ``<Color.BLUE|GREEN|RED: 7>``.



More information about the Python-checkins mailing list