From: Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com>
Date: Wed, 19 Jun 2024 22:11:30 +0000 (+0200)
Subject: [3.13] gh-118820: Zero-valued flag enum has no name (GH-118848) (GH-120759)
X-Git-Tag: v3.13.0b3~57
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=e415d2561b0410c21ab8627aa10b90b1145b1c70;p=thirdparty%2FPython%2Fcpython.git

[3.13] gh-118820: Zero-valued flag enum has no name (GH-118848) (GH-120759)

gh-118820: Zero-valued flag enum has no name (GH-118848)
(cherry picked from commit ed5ae6c4d76feaff06c2104c8ff864553b000253)

Co-authored-by: Nice Zombies <nineteendo19d0@gmail.com>
Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com>
---

diff --git a/Doc/howto/enum.rst b/Doc/howto/enum.rst
index 30be15230fc0..0b122ae72b07 100644
--- a/Doc/howto/enum.rst
+++ b/Doc/howto/enum.rst
@@ -1150,6 +1150,14 @@ the following are true:
     >>> (Color.RED | Color.GREEN).name
     'RED|GREEN'
 
+    >>> class Perm(IntFlag):
+    ...     R = 4
+    ...     W = 2
+    ...     X = 1
+    ...
+    >>> (Perm.R & Perm.W).name is None  # effectively Perm(0)
+    True
+
 - multi-bit flags, aka aliases, can be returned from operations::
 
     >>> Color.RED | Color.BLUE