Merge 3.11 into 3.10

github-actions · github-actions · commit f551b4c1e425 · 2023-02-04T23:51:26.000Z
diff --git a/c-api/allocation.po b/c-api/allocation.po
@@ -34,6 +34,11 @@ msgid ""
 "detector's set of observed objects. Other fields of the object are not "
 "affected."
 msgstr ""
+"新たにメモリ確保されたオブジェクト *op* に対し、型と初期状態での参照 "
+"(initial reference) を初期化します。初期化されたオブジェクトを返します。"
+"*type* からそのオブジェクトが循環参照ガベージ検出の機能を有する場合、検出機構"
+"が監視対象とするオブジェクトのセットに追加されます。オブジェクトの他のフィー"
+"ルドには影響を及ぼしません。"
 
 #: ../../c-api/allocation.rst:26
 msgid ""
diff --git a/distutils/apiref.po b/distutils/apiref.po
@@ -2001,6 +2001,9 @@ msgid ""
 "binaries will run (that is, the value of ``MACOSX_DEPLOYMENT_TARGET`` during "
 "the build of Python), not the OS version of the current system."
 msgstr ""
+"macOS システムでは、 OS バージョンは、現在のOSバージョンではなく、実行するバ"
+"イナリの最小バージョンを表しています。 (これは、Python をビルドするときの "
+"``MACOSX_DEPLOYMENT_TARGET`` の値です。)"
 
 #: ../../distutils/apiref.rst:1126
 msgid ""
@@ -2013,10 +2016,17 @@ msgid ""
 "build (ppc, i386, x86_64) and ``intel`` is used for a universal build with "
 "the i386 and x86_64 architectures"
 msgstr ""
+"macOS のユニバーサルバイナリビルドでは、アーキテクチャの値は現在のプロセッサ"
+"ではなく、ユニバーサルバイナリの状態を表しています。32bit ユニバーサルバイナ"
+"リではアーキテクチャは ``fat`` で、64bit ユニバーサルバイナリではアーキテク"
+"チャは ``fat64`` で、4-way ユニバーサルバイナリではアーキテクチャは "
+"``universal`` になります。Python 2.7 と Python 3.2 から 3-way ユニバーサルバ"
+"イナリ (ppc, i386, x86_64) には ``fat3`` が i386 と x86_64 ユニバーサルバイナ"
+"リには ``intel`` が使われるようになりました"
 
 #: ../../distutils/apiref.rst:1135
 msgid "Examples of returned values on macOS:"
-msgstr ""
+msgstr "macOS で返される値の例:"
 
 #: ../../distutils/apiref.rst:1137
 msgid "``macosx-10.3-ppc``"
@@ -2149,6 +2159,9 @@ msgid ""
 "``$variable`` can consist only of upper and lower case letters, numbers and "
 "an underscore. No { } or ( ) style quoting is available."
 msgstr ""
+"これは完全な文字列挿入関数ではないことに注意してください。 ``$variable`` の名"
+"前には大小英字、数字、アンダーバーだけを含むことができます。 { } や ( ) を"
+"使った引用形式は利用できません。"
 
 #: ../../distutils/apiref.rst:1208
 msgid ""
diff --git a/extending/building.po b/extending/building.po
@@ -55,6 +55,9 @@ msgid ""
 "It returns either a fully initialized module, or a :c:type:`PyModuleDef` "
 "instance. See :ref:`initializing-modules` for details."
 msgstr ""
+"この関数は完全に初期化されたモジュールか、 :c:type:`PyModuleDef` インスタンス"
+"を返します。\n"
+"詳しいことは :ref:`initializing-modules` を参照してください。"
 
 #: ../../extending/building.rst:25
 msgid ""
diff --git a/extending/embedding.po b/extending/embedding.po
@@ -428,6 +428,7 @@ msgid ""
 "``pythonX.Y-config --ldflags --embed`` will give you the recommended flags "
 "when linking:"
 msgstr ""
+"``pythonX.Y-config --ldflags --embed`` は推奨のリンクオプションを出力します:"
 
 #: ../../extending/embedding.rst:313
 msgid ""
diff --git a/extending/extending.po b/extending/extending.po
@@ -301,6 +301,15 @@ msgid ""
 "interpreter's main loop, this aborts the currently executing Python code and "
 "tries to find an exception handler specified by the Python programmer."
 msgstr ""
+"関数 *g* を呼び出す *f* が、前者の関数の呼び出しに失敗したことを検出すると、 "
+"*f* 自体はエラー値 (大抵は ``NULL`` や ``-1``) を返さねばなりません。しか"
+"し、 ``PyErr_*`` 関数群のいずれかを呼び出す必要は *ありません* --- なぜな"
+"ら、 *g* がすでに呼び出しているからです。次いで *f* を呼び出したコードもエ"
+"ラーを示す値を *自らを呼び出したコード* に返すことになりますが、同様に "
+"``PyErr_*`` は *呼び出しません* 。以下同様に続きます --- エラーの最も詳しい原"
+"因は、最初にエラーを検出した関数がすでに報告しているからです。エラーが "
+"Python インタプリタのメインループに到達すると、現在実行中の Python コードは一"
+"時停止し、 Python プログラマが指定した例外ハンドラを探し出そうとします。"
 
 #: ../../extending/extending.rst:168
 msgid ""
@@ -310,6 +319,11 @@ msgid ""
 "cause information about the cause of the error to be lost: most operations "
 "can fail for a variety of reasons.)"
 msgstr ""
+"(モジュールが ``PyErr_*`` 関数をもう一度呼び出して、より詳細なエラーメッセー"
+"ジを提供するような状況があります。このような状況ではそうすべきです。とはい"
+"え、一般的な規則としては、この関数を何度も呼び出す必要はなく、ともすればエ"
+"ラーの原因に関する情報を失う結果になりがちです: これにより、ほとんどの操作が"
+"様々な理由から失敗するかもしれません)"
 
 #: ../../extending/extending.rst:174
 msgid ""
@@ -505,6 +519,10 @@ msgid ""
 "``None``.   You need this idiom to do so (which is implemented by the :c:"
 "macro:`Py_RETURN_NONE` macro)::"
 msgstr ""
+"何ら有用な値を返さない関数 (:c:expr:`void` を返す関数) に対応する Python の関"
+"数は ``None`` を返さねばなりません。関数に ``None`` を返させるには、以下のよ"
+"うな慣用句を使います (この慣用句は :c:macro:`Py_RETURN_NONE` マクロに実装され"
+"ています)::"
 
 #: ../../extending/extending.rst:308
 msgid ""
@@ -1693,6 +1711,13 @@ msgid ""
 "module, retrieve the value of this name, and then retrieve the pointer from "
 "the Capsule."
 msgstr ""
+"Python はある拡張モジュールの C レベルの情報 (ポインタ) を別のモジュールに渡"
+"すための特殊な機構: Capsule (カプセル)を提供しています。 Capsule はポインタ "
+"(:c:expr:`void \\*`) を記憶する Python のデータ型です。 Capsule は C API を介"
+"してのみ生成したりアクセスしたりできますが、他の Python オブジェクトと同じよ"
+"うに受け渡しできます。とりわけ、Capsule は拡張モジュールの名前空間内にある名"
+"前に代入できます。他の拡張モジュールはこのモジュールを import でき、次に名前"
+"を取得し、最後にCapsule へのポインタを取得します。"
 
 #: ../../extending/extending.rst:1180
 msgid ""
@@ -1718,6 +1743,12 @@ msgid ""
 "of runtime type-safety; there is no feasible way to tell one unnamed Capsule "
 "from another."
 msgstr ""
+"どの方法を選ぶにしても、 Capsule の name を正しく設定することは重要です。 :c:"
+"func:`PyCapsule_New` は name 引数 (:c:expr:`const char \\*`) を取ります。 "
+"``NULL`` を name に渡すことも許可されていますが、 name を設定することを強く推"
+"奨します。正しく名前を付けられた Capsule はある程度の実行時型安全性を持ちま"
+"す。名前を付けられていない Capsule を他の Capsule と区別する現実的な方法はあ"
+"りません。"
 
 #: ../../extending/extending.rst:1193
 msgid ""
@@ -1749,6 +1780,13 @@ msgid ""
 "takes care of importing the module and retrieving its C API pointers; client "
 "modules only have to call this macro before accessing the C API."
 msgstr ""
+"以下の例では、名前を公開するモジュールの作者にほとんどの負荷が掛かりますが、"
+"よく使われるライブラリを作る際に適切なアプローチを実演します。このアプローチ"
+"では、全ての C API ポインタ (例中では一つだけですが!) を、 Capsule の値とな"
+"る :c:expr:`void` ポインタの配列に保存します。拡張モジュールに対応するヘッダ"
+"ファイルは、モジュールの import と C API ポインタを取得するよう手配するマクロ"
+"を提供します; クライアントモジュールは、C API にアクセスする前にこのマクロを"
+"呼ぶだけです。"
 
 #: ../../extending/extending.rst:1211
 msgid ""
diff --git a/extending/index.po b/extending/index.po
@@ -80,6 +80,12 @@ msgid ""
 "swig.org>`_ and `Numba <https://numba.pydata.org/>`_ offer both simpler and "
 "more sophisticated approaches to creating C and C++ extensions for Python."
 msgstr ""
+"このガイドがカバーするのは、このバージョンの CPython の一部として提供されてい"
+"る、拡張を作成するための基本的なツールだけです。\n"
+"`Cython <https://cython.org/>`_, `cffi <https://cffi.readthedocs.io>`_, "
+"`SWIG <https://www.swig.org>`_, `Numba <https://numba.pydata.org/>`_ のような"
+"サードパーティのツールは、 Python の C および C++ 拡張を作成するための、より"
+"簡潔かつより洗練された手法を提供します。"
 
 #: ../../extending/index.rst:40
 msgid ""
diff --git a/faq/design.po b/faq/design.po
@@ -301,7 +301,7 @@ msgstr "Python 3.8 以降ならできるよ!"
 msgid ""
 "Assignment expressions using the walrus operator ``:=`` assign a variable in "
 "an expression::"
-msgstr ""
+msgstr "セイウチ演算子 ``:=`` を使った代入式は、式の中で変数に代入します::"
 
 #: ../../faq/design.rst:164
 msgid "See :pep:`572` for more information."
@@ -472,6 +472,8 @@ msgid ""
 "else``. For literal values, or constants within a namespace, you can also "
 "use a ``match ... case`` statement."
 msgstr ""
+"``if... elif... elif... else`` の繰り返しで簡単に同じことができます。リテラル"
+"値や名前空間内の定数には、``match ... case``文を使うこともできます。"
 
 #: ../../faq/design.rst:265
 msgid ""
diff --git a/faq/programming.po b/faq/programming.po
@@ -1979,6 +1979,12 @@ msgid ""
 "why we say that for lists, ``+=`` is a \"shorthand\" for :meth:`!list."
 "extend`::"
 msgstr ""
+"なぜこれが起きるかを調べるためには、次の 2 点を知っている必要があります。(a) "
+"オブジェクトに :meth:`~object.__iadd__` 特殊メソッドが実装されている場合、拡"
+"張代入 ``+=`` が実行されるときにそれが呼び出され、その返り値が代入文で使われ"
+"ます; (b) リストでは、:meth:`!__iadd__` は :meth:`~list.extend` の呼び出しと"
+"等価で、リストを返します。こんな理由で、リストでは ``+=`` は :meth:`!list."
+"extend` の \"略記\" だと言ったのでした::"
 
 #: ../../faq/programming.rst:1397
 msgid "This is equivalent to::"
@@ -2007,6 +2013,9 @@ msgid ""
 "points to, that final assignment still results in an error, because tuples "
 "are immutable."
 msgstr ""
+":meth:`!__iadd__` は成功し、リストは拡張 (extend) されますが、``result`` が "
+"``a_tuple[0]`` が既に指しているオブジェクトと同じオブジェクトを指していたとし"
+"ても、タプルは不変なので、その最後の代入はやはりエラーとなります。"
 
 #: ../../faq/programming.rst:1421
 msgid ""
@@ -2124,6 +2133,11 @@ msgid ""
 "built-in types, e.g. ``isinstance(obj, str)`` or ``isinstance(obj, (int, "
 "float, complex))``."
 msgstr ""
+"ビルトイン関数 :func:`isinstance(obj, cls) <isinstance>` を使ってください。ク"
+"ラスのタプルを与えて ``isinstance(obj, (class1, class2, ...))`` のようにすれ"
+"ば、あるオブジェクトが任意の数のクラスのオブジェクトであるかを調べられます"
+"し、``isinstance(obj, str)`` や ``isinstance(obj, (int, float, complex))`` の"
+"ようにすれば、Python のビルトイン型のオブジェクトであるかも調べられます。"
 
 #: ../../faq/programming.rst:1499
 msgid ""
@@ -2201,19 +2215,28 @@ msgid ""
 "implementation of :meth:`!__setattr__` is roughly equivalent to the "
 "following::"
 msgstr ""
+"なお、一般的に委譲はトリッキーになりがちです。属性が設定される時には読み出さ"
+"れる時と同様に、そのクラスに :meth:`~object.__setattr__` メソッドを定義する必"
+"要があり、それには細心の注意が必要です。 :meth:`!__setattr__` の基本的な実装"
+"はおおよそ以下のようになります::"
 
 #: ../../faq/programming.rst:1604
 msgid ""
 "Most :meth:`!__setattr__` implementations must modify :meth:`self.__dict__ "
 "<object.__dict__>` to store local state for self without causing an infinite "
 "recursion."
 msgstr ""
+"たいてい、 :meth:`!__setattr__` 実装は :meth:`self.__dict__ <object."
+"__dict__>` を変更して、無限再帰を起こすことなくローカルな状態を保存するように"
+"しなければなりません。"
 
 #: ../../faq/programming.rst:1610
 msgid ""
 "How do I call a method defined in a base class from a derived class that "
 "extends it?"
 msgstr ""
+"基底クラスで定義されたメソッドを、そのクラスを継承した派生クラスから呼び出す"
+"にはどうしますか？"
 
 #: ../../faq/programming.rst:1612
 msgid "Use the built-in :func:`super` function::"
@@ -2238,6 +2261,10 @@ msgid ""
 "this trick is also handy if you want to decide dynamically (e.g. depending "
 "on availability of resources) which base class to use.  Example::"
 msgstr ""
+"基底クラスをエイリアス (alias) に代入しておいてから、そのエイリアスを継承する"
+"といいかもしれません。そうすればエイリアスに代入する値を変えるだけで済みま"
+"す。ちなみに、この手法は使用する基底クラスを動的に選びたいとき、例えば使える"
+"リソースによって選びたいときなどにも便利です。例::"
 
 #: ../../faq/programming.rst:1642
 msgid "How do I create static class data and static class methods?"
@@ -2387,6 +2414,9 @@ msgid ""
 "__del__` -- it simply decrements the object's reference count, and if this "
 "reaches zero :meth:`!__del__` is called."
 msgstr ""
+":keyword:`del` 文は必ずしも :meth:`~object.__del__` を呼び出すとは限りません "
+"-- これは単純にオブジェクトの参照カウントを減らすもので、カウントがゼロになっ"
+"たときに :meth:`!__del__` が呼び出されます。"
 
 #: ../../faq/programming.rst:1747
 msgid ""
@@ -2401,6 +2431,15 @@ msgid ""
 "run :func:`gc.collect` to force a collection, but there *are* pathological "
 "cases where objects will never be collected."
 msgstr ""
+"データ構造が循環リンク (子のそれぞれが親の参照を持ち、親のそれぞれが子のリス"
+"トを持つツリーなど) を含む場合、その参照カウントは決して 0 にはなりません。"
+"時々、Python はこのようなサイクルを検出するアルゴリズムを実行しますが、データ"
+"構造への参照がなくなってからこのガベージコレクタが実行されるまでいくらか時間"
+"が掛かるかもしれないので、 :meth:`!__del__` メソッドは不都合な予期できないタ"
+"イミングで呼び出されるかもしれません。これは問題を再現しようとするときに不便"
+"です。さらに悪いことに、オブジェクトの :meth:`!__del__` メソッドが実行される"
+"順序は任意です。 :func:`gc.collect` を起動して収集を強制することができます"
+"が、オブジェクトが決して回収されないような本当に病的な場合も *あります* 。"
 
 #: ../../faq/programming.rst:1758
 msgid ""
@@ -2411,6 +2450,13 @@ msgid ""
 "``close()`` and ``close()`` should make sure that it can be called more than "
 "once for the same object."
 msgstr ""
+"循環参照コレクタがあるとはいえ、オブジェクトに ``close()`` メソッドを明示的に"
+"定義し、使い終わったらいつでも呼び出せるようにするのはいいことです。\n"
+"``close()`` メソッドを使うと、サブオブジェクトを参照している属性を取り除けま"
+"す。\n"
+":meth:`!__del__` を直接呼び出さないでください -- :meth:`!__del__` は "
+"``close()`` を呼び出すでしょうし、 ``close()`` なら同じオブジェクトに対して複"
+"数回呼ばれてもいいことが保証されているでしょう。"
 
 #: ../../faq/programming.rst:1765
 msgid ""
@@ -2428,6 +2474,8 @@ msgid ""
 "Finally, if your :meth:`!__del__` method raises an exception, a warning "
 "message is printed to :data:`sys.stderr`."
 msgstr ""
+"最後に、 :meth:`!__del__` メソッドが例外を発生させた場合、警告のメッセージ"
+"が :data:`sys.stderr` に書きこまれます。"
 
 #: ../../faq/programming.rst:1783
 msgid "How do I get a list of all instances of a given class?"
@@ -2793,33 +2841,35 @@ msgstr "問題はインタプリタが以下の段階を実行することです
 
 #: ../../faq/programming.rst:2118
 msgid "main imports ``foo``"
-msgstr ""
+msgstr "main が ``foo`` をインポートする"
 
 #: ../../faq/programming.rst:2119
 msgid "Empty globals for ``foo`` are created"
-msgstr ""
+msgstr "``foo`` の空のグローバルが生成される"
 
 #: ../../faq/programming.rst:2120
 msgid "``foo`` is compiled and starts executing"
-msgstr ""
+msgstr "``foo`` がコンパイルされ実行を始める"
 
 #: ../../faq/programming.rst:2121
 msgid "``foo`` imports ``bar``"
-msgstr ""
+msgstr "``foo`` が ``bar`` をインポートする"
 
 #: ../../faq/programming.rst:2122
 msgid "Empty globals for ``bar`` are created"
-msgstr ""
+msgstr "``bar`` の空のグローバルが生成される"
 
 #: ../../faq/programming.rst:2123
 msgid "``bar`` is compiled and starts executing"
-msgstr ""
+msgstr "``bar`` がコンパイルされ実行を始める"
 
 #: ../../faq/programming.rst:2124
 msgid ""
 "``bar`` imports ``foo`` (which is a no-op since there already is a module "
 "named ``foo``)"
 msgstr ""
+"``bar`` が ``foo`` をインポートする(すでに ``foo`` という名前のモジュールがあ"
+"るので no-op となる)"
 
 #: ../../faq/programming.rst:2125
 msgid ""
@@ -2890,6 +2940,8 @@ msgid ""
 "Van Rossum doesn't like this approach much because the imports appear in a "
 "strange place, but it does work."
 msgstr ""
+"インポートが奇妙な場所に現れることから Van Rossum はこの方法をそれほど好みま"
+"せんが、これは有効です。"
 
 #: ../../faq/programming.rst:2150
 msgid ""
diff --git a/faq/windows.po b/faq/windows.po
diff --git a/howto/functional.po b/howto/functional.po
diff --git a/install/index.po b/install/index.po
diff --git a/installing/index.po b/installing/index.po
