Merge 3.11 into 3.10

github-actions · github-actions · commit 265f81c26462 · 2022-12-31T23:59:26.000Z
diff --git a/howto/enum.po b/howto/enum.po
@@ -25,7 +25,7 @@ msgstr ""
 
 #: ../../howto/enum.rst:3
 msgid "Enum HOWTO"
-msgstr ""
+msgstr "列挙型 HOWTO"
 
 #: ../../howto/enum.rst:0
 msgid "Author"
@@ -45,12 +45,17 @@ msgid ""
 "are similar to global variables, but they offer a more useful :func:"
 "`repr()`, grouping, type-safety, and a few other features."
 msgstr ""
+":class:`Enum` は、ユニークな値に束縛されたシンボル名の集合です。グローバル変"
+"数に似ていますが、 :func:`repr()` がより便利だったり、グルーピングの機能、型"
+"安全などいくつかの機能があります。"
 
 #: ../../howto/enum.rst:18
 msgid ""
 "They are most useful when you have a variable that can take one of a limited "
 "selection of values.  For example, the days of the week::"
 msgstr ""
+"これらは、限られた選択肢の値の一つを取る変数がある場合に便利です。例えば、曜"
+"日情報があります:"
 
 #: ../../howto/enum.rst:31
 msgid ""
@@ -60,13 +65,16 @@ msgstr ""
 
 #: ../../howto/enum.rst:34
 msgid "Case of Enum Members"
-msgstr ""
+msgstr "Enumメンバーは大文字/小文字？"
 
 #: ../../howto/enum.rst:36
 msgid ""
 "Because Enums are used to represent constants we recommend using UPPER_CASE "
 "names for members, and will be using that style in our examples."
 msgstr ""
+"Enumクラス群は定数を表現するために使われるため、メンバーの名前にはUPPER_CASE"
+"を使うことを推奨します。本ページのドキュメントのサンプルでもそのスタイルを採"
+"用します。"
 
 #: ../../howto/enum.rst:39
 msgid ""
@@ -242,6 +250,8 @@ msgstr ""
 msgid ""
 "The :meth:`_generate_next_value_` method must be defined before any members."
 msgstr ""
+":meth:`_generate_next_value_` メソッドは他のメンバーよりも前に定義される必要"
+"があります。"
 
 #: ../../howto/enum.rst:297
 msgid "Iteration"
@@ -344,17 +354,23 @@ msgid ""
 "then any value(s) given to the enum member will be passed into those "
 "methods. See `Planet`_ for an example."
 msgstr ""
+"注意: 列挙型で :meth:`__new__` および/または :meth:`__init__` を定義した場"
+"合、列挙型メンバーに与えられた値はすべてこれらのメソッドに渡されます。例 "
+"`Planet`_ を参照してください。"
 
 #: ../../howto/enum.rst:411
 msgid "Restricted Enum subclassing"
-msgstr ""
+msgstr "Enumのサブクラス化の制限"
 
 #: ../../howto/enum.rst:413
 msgid ""
 "A new :class:`Enum` class must have one base enum class, up to one concrete "
 "data type, and as many :class:`object`-based mixin classes as needed.  The "
 "order of these base classes is::"
 msgstr ""
+"新しい :class:`Enum` クラスは、ベースの enum クラスを1つ、具象データ型を1つ、"
+"複数の :class:`object` ベースのミックスインクラスが許容されます。これらのベー"
+"スクラスの順序は次の通りです::"
 
 #: ../../howto/enum.rst:420
 msgid ""
@@ -411,6 +427,8 @@ msgid ""
 "It is possible to modify how enum members are pickled/unpickled by defining :"
 "meth:`__reduce_ex__` in the enumeration class."
 msgstr ""
+"enum のメンバーをどう pickle 化/unpickle 化するかは、列挙型クラス内の :meth:"
+"`__reduce_ex__` で定義することで変更できます。"
 
 #: ../../howto/enum.rst:471
 msgid "Functional API"
@@ -502,7 +520,7 @@ msgstr "value"
 
 #: ../../howto/enum.rst:541
 msgid "What the new enum class will record as its name."
-msgstr ""
+msgstr "新しい enum クラスに記録されるそれ自身の名前です。"
 
 #: ../../howto/enum.rst:0
 msgid "names"
@@ -532,23 +550,23 @@ msgstr "module"
 
 #: ../../howto/enum.rst:560
 msgid "name of module where new enum class can be found."
-msgstr ""
+msgstr "新しい enum クラスが属するモジュールの名前です。"
 
 #: ../../howto/enum.rst:0
 msgid "qualname"
 msgstr "qualname"
 
 #: ../../howto/enum.rst:562
 msgid "where in module new enum class can be found."
-msgstr ""
+msgstr "新しい enum クラスが属するモジュールの場所です。"
 
 #: ../../howto/enum.rst:0
 msgid "type"
 msgstr "type"
 
 #: ../../howto/enum.rst:564
 msgid "type to mix in to new enum class."
-msgstr ""
+msgstr "新しい enum クラスに複合されるデータ型です。"
 
 #: ../../howto/enum.rst:0
 msgid "start"
@@ -595,7 +613,7 @@ msgstr ":class:`IntEnum` の値は他の用途では整数のように振る舞
 
 #: ../../howto/enum.rst:623
 msgid "StrEnum"
-msgstr ""
+msgstr "StrEnum"
 
 #: ../../howto/enum.rst:625
 msgid ""
@@ -631,6 +649,8 @@ msgid ""
 "Any operation on an :class:`IntFlag` member besides the bit-wise operations "
 "will lose the :class:`IntFlag` membership."
 msgstr ""
+":class:`IntFlag` メンバーに対してビット演算以外のどんな演算をしても、その結果"
+"は :class:`IntFlag` メンバーではなくなります。"
 
 #: ../../howto/enum.rst:657
 msgid ""
@@ -789,6 +809,10 @@ msgid ""
 "`int` above.  This restriction does not apply to mix-ins which only add "
 "methods and don't specify another type."
 msgstr ""
+":class:`Enum` のメンバーはどんなデータ型でも構いませんが、追加のデータ型 (例"
+"えば、上の例の :class:`int`) と複合させてしまうと、すべてのメンバーの値はその"
+"データ型でなければならなくなります。この制限は、メソッドの追加するだけの、他"
+"のデータ型を指定しない複合には適用されません。"
 
 #: ../../howto/enum.rst:826
 msgid ""
@@ -822,20 +846,25 @@ msgstr ""
 
 #: ../../howto/enum.rst:840
 msgid "When to use :meth:`__new__` vs. :meth:`__init__`"
-msgstr ""
+msgstr ":meth:`__init__`  と :meth:`__init__` のどちらを使うべきか"
 
 #: ../../howto/enum.rst:842
 msgid ""
 ":meth:`__new__` must be used whenever you want to customize the actual value "
 "of the :class:`Enum` member.  Any other modifications may go in either :meth:"
 "`__new__` or :meth:`__init__`, with :meth:`__init__` being preferred."
 msgstr ""
+":meth:`__new__` は :class:`Enum` メンバーの実際の値をカスタマイズしたいときに"
+"利用します。他の変更を加える場合、 :meth:`__new__` と :meth:`__init__` のどち"
+"らを利用するかは、:meth:`__init__` の方が望ましいでしょう。"
 
 #: ../../howto/enum.rst:846
 msgid ""
 "For example, if you want to pass several items to the constructor, but only "
 "want one of them to be the value::"
 msgstr ""
+"例えば、複数の値をコンストラクタに渡すが、その中の1つだけを値として使いたい場"
+"合は次のようにします:"
 
 #: ../../howto/enum.rst:873
 msgid "Finer Points"
@@ -909,6 +938,9 @@ msgid ""
 "``_generate_next_value_`` -- used by the `Functional API`_ and by :class:"
 "`auto` to get an appropriate value for an enum member; may be overridden"
 msgstr ""
+"``_generate_next_value_`` -- `Functional API`_ から利用され、 :class:`auto` "
+"が列挙型のメンバーの適切な値を取得するのに使われます。オーバーライドされま"
+"す。"
 
 #: ../../howto/enum.rst:905
 msgid ""
@@ -936,16 +968,21 @@ msgid ""
 "can be provided.  It will be checked against the actual order of the "
 "enumeration and raise an error if the two do not match::"
 msgstr ""
+"Pythono 2 / Python 3のコードの同期を取りやすくするために :attr:`_order_` 属性"
+"を提供できます。実際の列挙値の順序と比較して一致してなければエラーを送出しま"
+"す::"
 
 #: ../../howto/enum.rst:932
 msgid ""
 "In Python 2 code the :attr:`_order_` attribute is necessary as definition "
 "order is lost before it can be recorded."
 msgstr ""
+"Python 2のコードでは :attr:`_order_` 属性は定義順が記録される前消えてしまうた"
+"め、重要です。"
 
 #: ../../howto/enum.rst:937
 msgid "_Private__names"
-msgstr ""
+msgstr "_Private__names"
 
 #: ../../howto/enum.rst:939
 msgid ""
@@ -989,6 +1026,11 @@ msgid ""
 "enum's boolean evaluation depend on the member's value add the following to "
 "your class::"
 msgstr ""
+"(:class:`int`, :class:`str` などのような) 非 :class:`Enum` 型と複合させた "
+"enum クラスは、その複合された型の規則に従って評価されます;\n"
+"そうでない場合は、全てのメンバーは :data:`True` と評価されます。\n"
+"メンバーの値に依存する独自の enum の真偽値評価を行うには、クラスに次のコード"
+"を追加してください::"
 
 #: ../../howto/enum.rst:993
 msgid "Plain :class:`Enum` classes always evaluate as :data:`True`."
@@ -1128,6 +1170,8 @@ msgid ""
 "Enums have a custom metaclass that affects many aspects of both derived :"
 "class:`Enum` classes and their instances (members)."
 msgstr ""
+"Enum は :class:`Enum` 派生クラスやそれらのインスタンス (メンバー) 双方の多く"
+"の側面に影響を及ぼすカスタムメタクラスを持っています。"
 
 #: ../../howto/enum.rst:1123
 msgid "Enum Classes"
@@ -1156,6 +1200,10 @@ msgid ""
 "new ones are ever instantiated by returning only the existing member "
 "instances."
 msgstr ""
+"enum メンバーについて最も興味深いのは、それらがシングルトンであるということで"
+"す。:class:`EnumType` は enum クラス自身を作成し、メンバーを作成し、新しいイ"
+"ンスタンスが作成されていないかどうかを確認するために既存のメンバーインスタン"
+"スだけを返すカスタム :meth:`__new__` を追加します。"
 
 #: ../../howto/enum.rst:1146
 msgid ""
@@ -1164,6 +1212,10 @@ msgid ""
 "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 ""
+":class:`Enum`, :class:`IntEnum`, :class:`StrEnum`, :class:`Flag`, :class:"
+"`IntFlag` は用途の大部分をカバーすると予想されますが、そのすべてをカバーでき"
+"ているわけではありません。ここでは、そのまま、あるいは独自の列挙型を作る例と"
+"して使える、様々なタイプの列挙型を紹介します。"
 
 #: ../../howto/enum.rst:1153
 msgid "Omitting values"
@@ -1244,12 +1296,16 @@ msgid ""
 "To make a more general purpose ``AutoNumber``, add ``*args`` to the "
 "signature::"
 msgstr ""
+"``AutoNumber`` をより広い用途で使うには、シグニチャに ``*args`` を追加しま"
+"す::"
 
 #: ../../howto/enum.rst:1245
 msgid ""
 "Then when you inherit from ``AutoNumber`` you can write your own "
 "``__init__`` to handle any extra arguments::"
 msgstr ""
+"``AutoNumber`` を継承すると、追加の引数を取り扱える独自の ``__init__`` が書け"
+"ます。"
 
 #: ../../howto/enum.rst:1264
 msgid ""
@@ -1309,11 +1365,11 @@ msgstr ""
 
 #: ../../howto/enum.rst:1370
 msgid "TimePeriod"
-msgstr ""
+msgstr "TimePeriod"
 
 #: ../../howto/enum.rst:1372
 msgid "An example to show the :attr:`_ignore_` attribute in use::"
-msgstr ""
+msgstr ":attr:`_ignore_` 属性の使用方法のサンプルです::"
 
 #: ../../howto/enum.rst:1389
 msgid "Conforming input to Flag"
@@ -1328,7 +1384,7 @@ msgstr ""
 
 #: ../../howto/enum.rst:1411
 msgid "Subclassing EnumType"
-msgstr ""
+msgstr "EnumType をサブクラス化する"
 
 #: ../../howto/enum.rst:1413
 msgid ""
