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

miss-islington · nineteendo · picnixz · web-flow · commit 6421db1d4d86 · 2024-06-19T15:11:58.000-07:00
gh-118820: Zero-valued flag enum has no name (GH-118848) (cherry picked from commit ed5ae6c) 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
@@ -1129,6 +1129,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
