sync with cpython 6421db1d

Author: github-actions[bot]

howto/enum.po

@@ -8,7 +8,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.12\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2023-11-30 00:03+0000\n"
+"POT-Creation-Date: 2024-06-20 00:03+0000\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language-Team: LANGUAGE <[email protected]>\n"
@@ -972,78 +972,78 @@ msgstr ""
 msgid "names of pseudo-flags are constructed from their members' names::"
 msgstr ""
 
-#: ../../howto/enum.rst:1132
+#: ../../howto/enum.rst:1140
 msgid "multi-bit flags, aka aliases, can be returned from operations::"
 msgstr ""
 
-#: ../../howto/enum.rst:1143
+#: ../../howto/enum.rst:1151
 msgid ""
 "membership / containment checking: zero-valued flags are always considered "
 "to be contained::"
 msgstr ""
 
-#: ../../howto/enum.rst:1149
+#: ../../howto/enum.rst:1157
 msgid ""
 "otherwise, only if all bits of one flag are in the other flag will True be "
 "returned::"
 msgstr ""
 
-#: ../../howto/enum.rst:1158
+#: ../../howto/enum.rst:1166
 msgid ""
 "There is a new boundary mechanism that controls how out-of-range / invalid "
 "bits are handled: ``STRICT``, ``CONFORM``, ``EJECT``, and ``KEEP``:"
 msgstr ""
 
-#: ../../howto/enum.rst:1161
+#: ../../howto/enum.rst:1169
 msgid "STRICT --> raises an exception when presented with invalid values"
 msgstr ""
 
-#: ../../howto/enum.rst:1162
+#: ../../howto/enum.rst:1170
 msgid "CONFORM --> discards any invalid bits"
 msgstr ""
 
-#: ../../howto/enum.rst:1163
+#: ../../howto/enum.rst:1171
 msgid "EJECT --> lose Flag status and become a normal int with the given value"
 msgstr ""
 
-#: ../../howto/enum.rst:1164
+#: ../../howto/enum.rst:1172
 msgid "KEEP --> keep the extra bits"
 msgstr ""
 
-#: ../../howto/enum.rst:1166
+#: ../../howto/enum.rst:1174
 msgid "keeps Flag status and extra bits"
 msgstr ""
 
-#: ../../howto/enum.rst:1167
+#: ../../howto/enum.rst:1175
 msgid "extra bits do not show up in iteration"
 msgstr ""
 
-#: ../../howto/enum.rst:1168
+#: ../../howto/enum.rst:1176
 msgid "extra bits do show up in repr() and str()"
 msgstr ""
 
-#: ../../howto/enum.rst:1170
+#: ../../howto/enum.rst:1178
 msgid ""
 "The default for Flag is ``STRICT``, the default for ``IntFlag`` is "
 "``EJECT``, and the default for ``_convert_`` is ``KEEP`` (see ``ssl."
 "Options`` for an example of when ``KEEP`` is needed)."
 msgstr ""
 
-#: ../../howto/enum.rst:1178
+#: ../../howto/enum.rst:1186
 msgid "How are Enums and Flags different?"
 msgstr ""
 
-#: ../../howto/enum.rst:1180
+#: ../../howto/enum.rst:1188
 msgid ""
 "Enums have a custom metaclass that affects many aspects of both derived :"
 "class:`Enum` classes and their instances (members)."
 msgstr ""
 
-#: ../../howto/enum.rst:1185
+#: ../../howto/enum.rst:1193
 msgid "Enum Classes"
 msgstr ""
 
-#: ../../howto/enum.rst:1187
+#: ../../howto/enum.rst:1195
 msgid ""
 "The :class:`EnumType` metaclass is responsible for providing the :meth:"
 "`__contains__`, :meth:`__dir__`, :meth:`__iter__` and other methods that "
@@ -1054,11 +1054,11 @@ msgid ""
 "`__getnewargs__`, :meth:`__str__` and :meth:`__repr__`)."
 msgstr ""
 
-#: ../../howto/enum.rst:1196
+#: ../../howto/enum.rst:1204
 msgid "Flag Classes"
 msgstr ""
 
-#: ../../howto/enum.rst:1198
+#: ../../howto/enum.rst:1206
 msgid ""
 "Flags have an expanded view of aliasing: to be canonical, the value of a "
 "flag needs to be a power-of-two value, and not a duplicate name.  So, in "
@@ -1067,11 +1067,11 @@ msgid ""
 "considered an alias."
 msgstr ""
 
-#: ../../howto/enum.rst:1204
+#: ../../howto/enum.rst:1212
 msgid "Enum Members (aka instances)"
 msgstr ""
 
-#: ../../howto/enum.rst:1206
+#: ../../howto/enum.rst:1214
 msgid ""
 "The most interesting thing about enum members is that they are singletons. :"
 "class:`EnumType` creates them all while it is creating the enum class "
@@ -1080,193 +1080,193 @@ msgid ""
 "instances."
 msgstr ""
 
-#: ../../howto/enum.rst:1212
+#: ../../howto/enum.rst:1220
 msgid "Flag Members"
 msgstr ""
 
-#: ../../howto/enum.rst:1214
+#: ../../howto/enum.rst:1222
 msgid ""
 "Flag members can be iterated over just like the :class:`Flag` class, and "
 "only the canonical members will be returned.  For example::"
 msgstr ""
 
-#: ../../howto/enum.rst:1220
+#: ../../howto/enum.rst:1228
 msgid "(Note that ``BLACK``, ``PURPLE``, and ``WHITE`` do not show up.)"
 msgstr ""
 
-#: ../../howto/enum.rst:1222
+#: ../../howto/enum.rst:1230
 msgid ""
 "Inverting a flag member returns the corresponding positive value, rather "
 "than a negative value --- for example::"
 msgstr ""
 
-#: ../../howto/enum.rst:1228
+#: ../../howto/enum.rst:1236
 msgid ""
 "Flag members have a length corresponding to the number of power-of-two "
 "values they contain.  For example::"
 msgstr ""
 
-#: ../../howto/enum.rst:1238
+#: ../../howto/enum.rst:1246
 msgid "Enum Cookbook"
 msgstr ""
 
-#: ../../howto/enum.rst:1241
+#: ../../howto/enum.rst:1249
 msgid ""
 "While :class:`Enum`, :class:`IntEnum`, :class:`StrEnum`, :class:`Flag`, and :"
 "class:`IntFlag` are expected to cover the majority of use-cases, they cannot "
 "cover them all.  Here are recipes for some different types of enumerations "
 "that can be used directly, or as examples for creating one's own."
 msgstr ""
 
-#: ../../howto/enum.rst:1248
+#: ../../howto/enum.rst:1256
 msgid "Omitting values"
 msgstr ""
 
-#: ../../howto/enum.rst:1250
+#: ../../howto/enum.rst:1258
 msgid ""
 "In many use-cases, one doesn't care what the actual value of an enumeration "
 "is. There are several ways to define this type of simple enumeration:"
 msgstr ""
 
-#: ../../howto/enum.rst:1253
+#: ../../howto/enum.rst:1261
 msgid "use instances of :class:`auto` for the value"
 msgstr ""
 
-#: ../../howto/enum.rst:1254
+#: ../../howto/enum.rst:1262
 msgid "use instances of :class:`object` as the value"
 msgstr ""
 
-#: ../../howto/enum.rst:1255
+#: ../../howto/enum.rst:1263
 msgid "use a descriptive string as the value"
 msgstr ""
 
-#: ../../howto/enum.rst:1256
+#: ../../howto/enum.rst:1264
 msgid ""
 "use a tuple as the value and a custom :meth:`__new__` to replace the tuple "
 "with an :class:`int` value"
 msgstr ""
 
-#: ../../howto/enum.rst:1259
+#: ../../howto/enum.rst:1267
 msgid ""
 "Using any of these methods signifies to the user that these values are not "
 "important, and also enables one to add, remove, or reorder members without "
 "having to renumber the remaining members."
 msgstr ""
 
-#: ../../howto/enum.rst:1265
+#: ../../howto/enum.rst:1273
 msgid "Using :class:`auto`"
 msgstr ""
 
-#: ../../howto/enum.rst:1267
+#: ../../howto/enum.rst:1275
 msgid "Using :class:`auto` would look like::"
 msgstr ""
 
-#: ../../howto/enum.rst:1279
+#: ../../howto/enum.rst:1287
 msgid "Using :class:`object`"
 msgstr ""
 
-#: ../../howto/enum.rst:1281
+#: ../../howto/enum.rst:1289
 msgid "Using :class:`object` would look like::"
 msgstr ""
 
-#: ../../howto/enum.rst:1291
+#: ../../howto/enum.rst:1299
 msgid ""
 "This is also a good example of why you might want to write your own :meth:"
 "`__repr__`::"
 msgstr ""
 
-#: ../../howto/enum.rst:1307
+#: ../../howto/enum.rst:1315
 msgid "Using a descriptive string"
 msgstr ""
 
-#: ../../howto/enum.rst:1309
+#: ../../howto/enum.rst:1317
 msgid "Using a string as the value would look like::"
 msgstr ""
 
-#: ../../howto/enum.rst:1321
+#: ../../howto/enum.rst:1329
 msgid "Using a custom :meth:`__new__`"
 msgstr ""
 
-#: ../../howto/enum.rst:1323
+#: ../../howto/enum.rst:1331
 msgid "Using an auto-numbering :meth:`__new__` would look like::"
 msgstr ""
 
-#: ../../howto/enum.rst:1340
+#: ../../howto/enum.rst:1348
 msgid ""
 "To make a more general purpose ``AutoNumber``, add ``*args`` to the "
 "signature::"
 msgstr ""
 
-#: ../../howto/enum.rst:1350
+#: ../../howto/enum.rst:1358
 msgid ""
 "Then when you inherit from ``AutoNumber`` you can write your own "
 "``__init__`` to handle any extra arguments::"
 msgstr ""
 
-#: ../../howto/enum.rst:1369
+#: ../../howto/enum.rst:1377
 msgid ""
 "The :meth:`__new__` method, if defined, is used during creation of the Enum "
 "members; it is then replaced by Enum's :meth:`__new__` which is used after "
 "class creation for lookup of existing members."
 msgstr ""
 
-#: ../../howto/enum.rst:1375
+#: ../../howto/enum.rst:1383
 msgid ""
 "*Do not* call ``super().__new__()``, as the lookup-only ``__new__`` is the "
 "one that is found; instead, use the data type directly -- e.g.::"
 msgstr ""
 
-#: ../../howto/enum.rst:1382
+#: ../../howto/enum.rst:1390
 msgid "OrderedEnum"
 msgstr ""
 
-#: ../../howto/enum.rst:1384
+#: ../../howto/enum.rst:1392
 msgid ""
 "An ordered enumeration that is not based on :class:`IntEnum` and so "
 "maintains the normal :class:`Enum` invariants (such as not being comparable "
 "to other enumerations)::"
 msgstr ""
 
-#: ../../howto/enum.rst:1418
+#: ../../howto/enum.rst:1426
 msgid "DuplicateFreeEnum"
 msgstr ""
 
-#: ../../howto/enum.rst:1420
+#: ../../howto/enum.rst:1428
 msgid ""
 "Raises an error if a duplicate member value is found instead of creating an "
 "alias::"
 msgstr ""
 
-#: ../../howto/enum.rst:1445
+#: ../../howto/enum.rst:1453
 msgid ""
 "This is a useful example for subclassing Enum to add or change other "
 "behaviors as well as disallowing aliases.  If the only desired change is "
 "disallowing aliases, the :func:`unique` decorator can be used instead."
 msgstr ""
 
-#: ../../howto/enum.rst:1451
+#: ../../howto/enum.rst:1459
 msgid "Planet"
 msgstr ""
 
-#: ../../howto/enum.rst:1453
+#: ../../howto/enum.rst:1461
 msgid ""
 "If :meth:`__new__` or :meth:`__init__` is defined, the value of the enum "
 "member will be passed to those methods::"
 msgstr ""
 
-#: ../../howto/enum.rst:1482
+#: ../../howto/enum.rst:1490
 msgid "TimePeriod"
 msgstr ""
 
-#: ../../howto/enum.rst:1484
+#: ../../howto/enum.rst:1492
 msgid "An example to show the :attr:`_ignore_` attribute in use::"
 msgstr ""
 
-#: ../../howto/enum.rst:1503
+#: ../../howto/enum.rst:1511
 msgid "Subclassing EnumType"
 msgstr ""
 
-#: ../../howto/enum.rst:1505
+#: ../../howto/enum.rst:1513
 msgid ""
 "While most enum needs can be met by customizing :class:`Enum` subclasses, "
 "either with class decorators or custom functions, :class:`EnumType` can be "