incorporate feedback from Nick Coghlan

- clarify that Color is an intEnum
- change references to 3.9 to 3.10

Author: ethanfurman

pep-0663.txt

@@ -9,7 +9,7 @@ Type: Informational
 Content-Type: text/x-rst
 Created: 23-Feb-2013
 Python-Version: 3.11
-Post-History:
+Post-History: 20-Jul-2021
 Resolution:
 
 
@@ -51,16 +51,17 @@ should be true (and the same for ``format()``).
 
 IntEnum, IntFlag, and StrEnum should be as close to a drop-in replacement of
 existing integer and string constants as is possible.  Towards that goal, the
-str() output of each should be its inherent value; i.e.::
+str() output of each should be its inherent value; e.g. if ``Color`` is an
+``IntEnum``::
 
     >>> Color.RED
     <Color.RED: 1>
     >>> str(Color.RED)
-    1
+    '1'
     >>> format(Color.RED)
     '1'
 
-Note that format() already produces the correct output, only str() needs
+Note that format() already produces the correct output in 3.10, only str() needs
 updating.
 
 As much as possible, the ``str()`, ``repr()``, and ``format()`` of enum members
@@ -112,32 +113,32 @@ behavior, while the last shows the final result:
 +-------------+----------+-----------------+------------+-----------------------+-----------------------+------------------------+-----------------------+
 | type                   | enum repr()     | enum str() | enum format()         | flag repr()           | flag str()             | flag format()         |
 +-------------+----------+-----------------+------------+-----------------------+-----------------------+------------------------+-----------------------+
-| standard    | 3.9      |                 |            |                       | <Color.RED|GREEN: 3>  | Color.RED|GREEN        | Color.RED|GREEN       |
+| standard    | 3.10     |                 |            |                       | <Color.RED|GREEN: 3>  | Color.RED|GREEN        | Color.RED|GREEN       |
 |             +----------+-----------------+------------+-----------------------+-----------------------+------------------------+-----------------------+
 |             | new      |                 |            |                       | <Color(3): RED|GREEN> | Color.RED|Color.GREEN  | Color.RED|Color.GREEN |
 +-------------+----------+-----------------+------------+-----------------------+-----------------------+------------------------+-----------------------+
 +-------------+----------+-----------------+------------+-----------------------+-----------------------+------------------------+-----------------------+
-| user mixed  | 3.9      |                 |            | 1                     | <Grey.WHITE: 1>       |                        | 1                     |
+| user mixed  | 3.10     |                 |            | 1                     | <Grey.WHITE: 1>       |                        | 1                     |
 |             +----------+-----------------+------------+-----------------------+-----------------------+------------------------+-----------------------+
 |             | new      |                 |            | Grey.WHITE            | <Grey(1): WHITE>      |                        | Grey.WHITE            |
 +-------------+----------+-----------------+------------+-----------------------+-----------------------+------------------------+-----------------------+
 +-------------+----------+-----------------+------------+-----------------------+-----------------------+------------------------+-----------------------+
-| int drop-in | 3.9      |                 | Hue.LIGHT  |                       | <Color.RED|GREEN: 3>  | Color.RED|GREEN        |                       |
+| int drop-in | 3.10     |                 | Hue.LIGHT  |                       | <Color.RED|GREEN: 3>  | Color.RED|GREEN        |                       |
 |             +----------+-----------------+------------+-----------------------+-----------------------+------------------------+-----------------------+
 |             | new      |                 | -1         |                       | <Color(3): RED|GREEN> | 3                      |                       |
 +-------------+----------+-----------------+------------+-----------------------+-----------------------+------------------------+-----------------------+
 +-------------+----------+-----------------+------------+-----------------------+-----------------------+------------------------+-----------------------+
-| global      | 3.9      | <Hue.LIGHT: -1> | Hue.LIGHT  | Hue.LIGHT             | <Color.RED|GREEN: 3>  | Color.RED|GREEN        | Color.RED|GREEN       |
+| global      | 3.10     | <Hue.LIGHT: -1> | Hue.LIGHT  | Hue.LIGHT             | <Color.RED|GREEN: 3>  | Color.RED|GREEN        | Color.RED|GREEN       |
 |             +----------+-----------------+------------+-----------------------+-----------------------+------------------------+-----------------------+
 |             | new      | tools.LIGHT     | LIGHT      | LIGHT                 | tools.RED|tools.GREEN | RED|GREEN              | RED|GREEN             |
 +-------------+----------+-----------------+------------+-----------------------+-----------------------+------------------------+-----------------------+
 +-------------+----------+-----------------+------------+-----------------------+-----------------------+------------------------+-----------------------+
-| user mixed  | 3.9      | <Grey.WHITE: 1  | Grey.WHITE | Grey.WHITE            | <Grey.WHITE: 1>       | Grey.WHITE             | 1                     |
+| user mixed  | 3.10     | <Grey.WHITE: 1  | Grey.WHITE | Grey.WHITE            | <Grey.WHITE: 1>       | Grey.WHITE             | 1                     |
 |             +----------+-----------------+------------+-----------------------+-----------------------+------------------------+-----------------------+
 |             | new      | tools.WHITE     | WHITE      | WHITE                 | tools.WHITE           | WHITE                  | WHITE                 |
 +-------------+----------+-----------------+------------+-----------------------+-----------------------+------------------------+-----------------------+
 +-------------+----------+-----------------+------------+-----------------------+-----------------------+------------------------+-----------------------+
-| int drop-in | 3.9      | <Hue.LIGHT: -1> | Hue.LIGHT  |                       | <Color.RED|GREEN: 3>  | Color.RED|GREEN        |                       |
+| int drop-in | 3.10     | <Hue.LIGHT: -1> | Hue.LIGHT  |                       | <Color.RED|GREEN: 3>  | Color.RED|GREEN        |                       |
 |             +----------+-----------------+------------+-----------------------+-----------------------+------------------------+-----------------------+
 |             | new      | tools.LIGHT     | -1         |                       | tools.RED|tools.GREEN | 3                      |                       |
 +-------------+----------+-----------------+------------+-----------------------+-----------------------+------------------------+-----------------------+