[Python-checkins] bpo-46059: Clarify pattern-matching example in "control flow" docs (GH-30079)

[miss-islington]

https://github.com/python/cpython/commit/503803d8c19be91becc09ca59f3febcbc324d6d2
commit: 503803d8c19be91becc09ca59f3febcbc324d6d2
branch: 3.10
author: Miss Islington (bot) <31488909+miss-islington at users.noreply.github.com>
committer: miss-islington <31488909+miss-islington at users.noreply.github.com>
date: 2021-12-14T07:25:32-08:00
summary:

bpo-46059: Clarify pattern-matching example in "control flow" docs (GH-30079)


The "Color" example in the pattern-matching section of the "control flow" documentation is not immediately runnable, leading to confusion.

Co-authored-by: Ken Jin <28750310+Fidget-Spinner at users.noreply.github.com>
(cherry picked from commit 1cbb88736c32ac30fd530371adf53fe7554be0a5)

Co-authored-by: Alex Waygood <Alex.Waygood at Gmail.com>

files:
M Doc/tutorial/controlflow.rst

diff --git a/Doc/tutorial/controlflow.rst b/Doc/tutorial/controlflow.rst
index a819756602612..fad8746014646 100644
--- a/Doc/tutorial/controlflow.rst
+++ b/Doc/tutorial/controlflow.rst
@@ -395,9 +395,11 @@ Several other key features of this statement:
 
       from enum import Enum
       class Color(Enum):
-          RED = 0
-          GREEN = 1
-          BLUE = 2
+          RED = 'red'
+          GREEN = 'green'
+          BLUE = 'blue'
+
+      color = Color(input("Enter your choice of 'red', 'blue' or 'green': "))
 
       match color:
           case Color.RED: