python
diff --git a/‎c-api/stable.po
Lines changed: 99 additions & 6 deletions b/‎c-api/stable.po
Lines changed: 99 additions & 6 deletions
diff --git a/‎howto/logging.po
Lines changed: 1 addition & 1 deletion b/‎howto/logging.po
Lines changed: 1 addition & 1 deletion
diff --git a/‎library/ftplib.po
Lines changed: 17 additions & 0 deletions b/‎library/ftplib.po
Lines changed: 17 additions & 0 deletions
diff --git a/‎library/gettext.po
Lines changed: 14 additions & 0 deletions b/‎library/gettext.po
Lines changed: 14 additions & 0 deletions
@@ -24,7 +24,7 @@ msgstr ""
 
 #: ../../c-api/stable.rst:7
 msgid "C API Stability"
-msgstr ""
+msgstr "C API の安定性"
 
 #: ../../c-api/stable.rst:9
 msgid ""
@@ -34,6 +34,11 @@ msgid ""
 "API. Changing existing API or removing API is only done after a deprecation "
 "period or to fix serious issues."
 msgstr ""
+"Python の C API は、 Backwards Compatibility Policy, :pep:`387` によって保護"
+"されています。C API はマイナーリリースごとに変更されますが(例えば 3.9 から "
+"3.10 へ)、ほとんどの変更はソース互換であり、通常は新しい API を追加するだけで"
+"す。既存の API を変更したり、 API を削除したりするのは、非推奨期間の後か、深"
+"刻な問題を修正する場合のみです。"
 
 #: ../../c-api/stable.rst:15
 msgid ""
@@ -43,12 +48,19 @@ msgid ""
 "work on 3.10.8 and vice versa, but will need to be compiled separately for "
 "3.9.x and 3.10.x."
 msgstr ""
+"CPython の Application Binary Interface(ABI)は、マイナーリリース間で前方およ"
+"び後方互換性があります(これらが同じ方法でコンパイルされた場合。以下の :ref:"
+"`stable-abi-platform` を参照)。そのため、Python 3.10.0 用にコンパイルされた"
+"コードは 3.10.8 で動作し、その逆も同様ですが、 3.9.x と 3.10.x では別々にコン"
+"パイルする必要があります。"
 
 #: ../../c-api/stable.rst:21
 msgid ""
 "Names prefixed by an underscore, such as ``_Py_InternalState``, are private "
 "API that can change without notice even in patch releases."
 msgstr ""
+"``_Py_InternalState`` のようにアンダースコアが前につくものは、パッチリリース"
+"でも予告なく変更される可能性があるプライベートAPIです。"
 
 #: ../../c-api/stable.rst:26
 msgid "Stable Application Binary Interface"
@@ -61,6 +73,10 @@ msgid ""
 "multiple versions of Python. Contents of the Limited API are :ref:`listed "
 "below <stable-abi-list>`."
 msgstr ""
+"Python 3.2 では、 Python の C API のサブセットである *Limited API* が導入され"
+"ました。Limited API のみを使用する拡張機能は、一度コンパイルすれば、複数の"
+"バージョンの Python で動作させることができます。Limited API の内容は :ref:"
+"`listed below <stable-abi-list>` です。"
 
 #: ../../c-api/stable.rst:33
 msgid ""
@@ -69,19 +85,28 @@ msgid ""
 "symbols exposed in the Limited API, but also other ones – for example, "
 "functions necessary to support older versions of the Limited API."
 msgstr ""
+"これを可能にするために、 Python は *Stable ABI* を提供しています。これは、"
+"Python 3.x のバージョン間で互換性を保つシンボルの集合です。Stable ABI には、 "
+"Limited API で公開されているシンボルだけでなく、 Limited API の古いバージョン"
+"をサポートするために必要な関数など、他のシンボルも含まれています。"
 
 #: ../../c-api/stable.rst:38
 msgid ""
 "(For simplicity, this document talks about *extensions*, but the Limited API "
 "and Stable ABI work the same way for all uses of the API – for example, "
 "embedding Python.)"
 msgstr ""
+"(簡単にするため、このドキュメントでは *拡張機能* について話していますが、 "
+"Limited API と Stable ABI は、 API のすべての使用、たとえばPythonの組み込みに"
+"対して同じように動作します)"
 
 #: ../../c-api/stable.rst:44
 msgid ""
 "Define this macro before including ``Python.h`` to opt in to only use the "
 "Limited API, and to select the Limited API version."
 msgstr ""
+"このマクロを ``Python.h`` をインクルードする前に定義することで、 Limited API "
+"のみを使用することを選択し、 Limited API バージョンを選択することができます。"
 
 #: ../../c-api/stable.rst:47
 msgid ""
@@ -91,26 +116,39 @@ msgid ""
 "the specified one onward, and can use Limited API introduced up to that "
 "version."
 msgstr ""
+"``Py_LIMITED_API`` を :c:data:`PY_VERSION_HEX` の値として定義し、拡張機能がサ"
+"ポートする Python の最低バージョンに対応します。この拡張機能は、指定された"
+"バージョン以降のすべての Python 3 リリースで再コンパイルせずに動作し、その"
+"バージョンまでに導入された Limited API を使用することができます。"
 
 #: ../../c-api/stable.rst:53
 msgid ""
 "Rather than using the ``PY_VERSION_HEX`` macro directly, hardcode a minimum "
 "minor version (e.g. ``0x030A0000`` for Python 3.10) for stability when "
 "compiling with future Python versions."
 msgstr ""
+"``PY_VERSION_HEX`` マクロを直接使うのではなく、将来の Python のバージョンでコ"
+"ンパイルするときの安定性のために、最小のマイナーバージョン(例えば、 Python "
+"3.10なら ``0x030A0000`` )をハードコードします。"
 
 #: ../../c-api/stable.rst:57
 msgid ""
 "You can also define ``Py_LIMITED_API`` to ``3``. This works the same as "
 "``0x03020000`` (Python 3.2, the version that introduced Limited API)."
 msgstr ""
+"また、 ``Py_LIMITED_API`` を ``3`` に定義することができます。これは "
+"``0x03020000`` (Python 3.2, Limited API が導入されたバージョン)と同じように動"
+"作します。"
 
 #: ../../c-api/stable.rst:60
 msgid ""
 "On Windows, extensions that use the Stable ABI should be linked against "
 "``python3.dll`` rather than a version-specific library such as ``python39."
 "dll``."
 msgstr ""
+"Windows では、 Stable ABI を使用する拡張機能は、 ``python39.dll`` のような"
+"バージョン固有のライブラリではなく、 ``python3.dll`` に対してリンクする必要が"
+"あります。"
 
 #: ../../c-api/stable.rst:64
 msgid ""
@@ -120,30 +158,45 @@ msgid ""
 "to ensure that, for example, extensions built with the 3.10+ Limited API are "
 "not installed for lower versions of Python."
 msgstr ""
+"いくつかのプラットフォームでは、 Python は ``abi3`` タグで名付けられた共有ラ"
+"イブラリファイルを探して読み込みます(例: ``mymodule.abi3.so``)。このような拡"
+"張モジュールが Stable ABI に適合しているかどうかはチェックされません。ユー"
+"ザー(またはそのパッケージングツール)は、たとえば 3.10+ Limited API でビルドさ"
+"れた拡張モジュールが、それ以下のバージョンの Python にインストールされないこ"
+"とを確認する必要があります。"
 
 #: ../../c-api/stable.rst:71
 msgid ""
 "All functions in the Stable ABI are present as functions in Python's shared "
 "library, not solely as macros. This makes them usable from languages that "
 "don't use the C preprocessor."
 msgstr ""
+"Stable ABI に含まれるすべての関数は、マクロとしてだけでなく、 Python の共有ラ"
+"イブラリの関数として存在します。そのため、Cプリプロセッサを使用しない言語から"
+"使用することができます。"
 
 #: ../../c-api/stable.rst:77
 msgid "Limited API Scope and Performance"
-msgstr ""
+msgstr "APIスコープとパフォーマンスの制限"
 
 #: ../../c-api/stable.rst:79
 msgid ""
 "The goal for the Limited API is to allow everything that is possible with "
 "the full C API, but possibly with a performance penalty."
 msgstr ""
+"Limited API の目標は、フル C API で可能なすべてのことを実現することですが、お"
+"そらく性能上の制約があります。"
 
 #: ../../c-api/stable.rst:82
 msgid ""
 "For example, while :c:func:`PyList_GetItem` is available, its “unsafe” macro "
 "variant :c:func:`PyList_GET_ITEM` is not. The macro can be faster because it "
 "can rely on version-specific implementation details of the list object."
 msgstr ""
+"例えば、 :c:func:`PyList_GetItem` は利用可能ですが、その “unsafe” マクロの変"
+"種 :c:func:`PyList_GET_ITEM` は利用できません。このマクロは、リストオブジェク"
+"トのバージョン固有の実装の詳細に依存することができるため、より高速に処理する"
+"ことができます。"
 
 #: ../../c-api/stable.rst:87
 msgid ""
@@ -152,6 +205,10 @@ msgid ""
 "allowing stability as Python's data structures are improved, but possibly "
 "reducing performance."
 msgstr ""
+"``Py_LIMITED_API`` を定義しないと、いくつかの C API 関数がインライン化された"
+"り、マクロに置き換わったりします。``Py_LIMITED_API`` を定義すると、このインラ"
+"イン化が無効になり、 Python のデータ構造が改善されても安定した動作が可能にな"
+"りますが、性能が低下する可能性があります。"
 
 #: ../../c-api/stable.rst:92
 msgid ""
@@ -162,10 +219,16 @@ msgid ""
 "where a version-specific one is not available – for example, for prereleases "
 "of an upcoming Python version."
 msgstr ""
+"``Py_LIMITED_API`` の定義を省くことで、 Limited API 拡張をバージョン固有の "
+"ABI でコンパイルすることが可能です。これにより、その Python のバージョンでパ"
+"フォーマンスを向上させることができますが、互換性は制限されます。"
+"``Py_LIMITED_API`` でコンパイルすると、バージョンに依存しない拡張機能が利用で"
+"きない場合、例えば、次期 Python バージョンのプレリリースに対応した拡張モ"
+"ジュールを配布することができるようになります。"
 
 #: ../../c-api/stable.rst:101
 msgid "Limited API Caveats"
-msgstr ""
+msgstr "制限付きAPIの注意点"
 
 #: ../../c-api/stable.rst:103
 msgid ""
@@ -174,6 +237,10 @@ msgid ""
 "only covers definitions, but an API also includes other issues, such as "
 "expected semantics."
 msgstr ""
+"``Py_LIMITED_API`` でコンパイルすることは、 Limited API や Stable ABI に準拠"
+"したコードであることを完全に保証するものではないことに注意してください。"
+"``Py_LIMITED_API`` は定義だけをカバーしていますが、 API には期待されるセマン"
+"ティクスのような他の課題も含まれています。"
 
 #: ../../c-api/stable.rst:108
 msgid ""
@@ -184,18 +251,28 @@ msgid ""
 "the argument will be used directly, causing a ``NULL`` dereference and "
 "crash. A similar argument works for fields of structs."
 msgstr ""
+"``Py_LIMITED_API`` が防げない問題の1つは、 Python の下位バージョンでは無効な"
+"引数を持つ関数を呼び出すことです。例えば、引数に ``NULL`` を受け取る関数を考"
+"えてみましょう。Python 3.9 では ``NULL`` はデフォルトの挙動を選択しますが、"
+"Python 3.8 ではこの引数は直接使用され、 ``NULL`` の参照外れを起こしクラッシュ"
+"します。同様の引数は、構造体のフィールドに対しても機能します。"
 
 #: ../../c-api/stable.rst:115
 msgid ""
 "Another issue is that some struct fields are currently not hidden when "
 "``Py_LIMITED_API`` is defined, even though they're part of the Limited API."
 msgstr ""
+"もう一つの問題は、一部の構造体フィールドがLimited APIの一部であるにもかかわら"
+"ず、 ``Py_LIMITED_API`` が定義されたときに現在非表示になっていないことです。"
 
 #: ../../c-api/stable.rst:118
 msgid ""
 "For these reasons, we recommend testing an extension with *all* minor Python "
 "versions it supports, and preferably to build with the *lowest* such version."
 msgstr ""
+"これらの理由から、私たちは拡張モジュールがサポートする *すべての* マイナーな "
+"Python バージョンでテストすること、そしてできれば *最も低い* バージョンでビル"
+"ドすることを推奨します。"
 
 #: ../../c-api/stable.rst:121
 msgid ""
@@ -204,6 +281,10 @@ msgid ""
 "few private declarations are exposed for technical reasons (or even "
 "unintentionally, as bugs)."
 msgstr ""
+"また、使用するすべての API のドキュメントを確認し、それが明示的に Limited "
+"API の一部であるかどうかをチェックすることをお勧めします。``Py_LIMITED_API`` "
+"が定義されていても、技術的な理由で(あるいはバグとして意図せず)いくつかのプラ"
+"イベート宣言が公開されることがあります。"
 
 #: ../../c-api/stable.rst:126
 msgid ""
@@ -213,10 +294,14 @@ msgid ""
 "particular, parts of the Limited API may be deprecated and removed, provided "
 "that the Stable ABI stays stable."
 msgstr ""
+"Python 3.8 で ``Py_LIMITED_API`` をコンパイルすると、その拡張モジュールは "
+"Python 3.12 で動作しますが、必ずしも Python 3.12 で *コンパイル* できるとは限"
+"らないことに注意してください。特に、Limited API の一部は、 Stable ABI が安定"
+"している限り、非推奨で削除されるかもしれません。"
 
 #: ../../c-api/stable.rst:136
 msgid "Platform Considerations"
-msgstr ""
+msgstr "プラットフォームで考慮すべき点"
 
 #: ../../c-api/stable.rst:138
 msgid ""
@@ -225,6 +310,10 @@ msgid ""
 "ABI, these details define a “platform”. They usually depend on the OS type "
 "and processor architecture"
 msgstr ""
+"ABI の安定性は Python だけでなく、使用するコンパイラ、低レベルのライブラリ、"
+"コンパイラのオプションにも依存します。安定した ABI の目的では、これらの詳細が"
+"「プラットフォーム」を定義します。通常、 OS の種類とプロセッサのアーキテク"
+"チャに依存します。"
 
 #: ../../c-api/stable.rst:143
 msgid ""
@@ -233,11 +322,15 @@ msgid ""
 "does not break the Stable ABI. This is the case with Windows and macOS "
 "releases from ``python.org`` and many third-party distributors."
 msgstr ""
+"特定のプラットフォーム上のすべての Python バージョンが安定版 ABI を破壊しない"
+"方法でビルドされていることを保証するのは、 Python の各特定配布者の責任です。"
+"これは ``python.org`` や多くのサードパーティーの配布元からの Windows と "
+"macOS のリリースの場合です。"
 
 #: ../../c-api/stable.rst:153
 msgid "Contents of Limited API"
-msgstr ""
+msgstr "限定版APIの内容"
 
 #: ../../c-api/stable.rst:156
 msgid "Currently, the Limited API includes the following items:"
-msgstr ""
+msgstr "現在、Limited APIには以下の項目が含まれています::"
@@ -763,7 +763,7 @@ msgid ""
 "the last two paragraphs in this section."
 msgstr ""
 "これらのメソッドを、生成したすべてのロガーに毎回呼び出さなければならないわけ"
-"ではありません。最後の 2 段落を参照してください。"
+"ではありません。この節の最後の 2 段落を参照してください。"
 
 #: ../../howto/logging.rst:450
 msgid ""
 
@@ -39,6 +39,13 @@ msgid ""
 "mod:`urllib.request` to handle URLs that use FTP.  For more information on "
 "FTP (File Transfer Protocol), see internet :rfc:`959`."
 msgstr ""
+"このモジュールでは :class:`FTP` クラスと、それに関連するいくつかの項目を定義"
+"しています。 :class:`FTP` クラスは、FTPプロトコルのクライアント側の機能を備え"
+"ています。このクラスを使うとFTPのいろいろな機能の自動化、例えば他のFTPサーバ"
+"のミラーリングといったことを実行するPythonプログラムを書くことができます。ま"
+"た、 :mod:`urllib.request` モジュールもFTPを使うURLを操作するのにこのクラスを"
+"使っています。 FTP (File Transfer Protocol)についての詳しい情報はinternet :"
+"rfc:`959` を参照して下さい。"
 
 #: ../../library/ftplib.rst:22
 msgid "The default encoding is UTF-8, following :rfc:`2640`."
@@ -350,6 +357,8 @@ msgid ""
 "Enable \"passive\" mode if *val* is true, otherwise disable passive mode. "
 "Passive mode is on by default."
 msgstr ""
+"*val* が真の場合 \"パッシブ\" モードを有効化し、偽の場合は無効化します。 デ"
+"フォルトではパッシブモードです。"
 
 #: ../../library/ftplib.rst:290
 msgid ""
@@ -361,6 +370,14 @@ msgid ""
 "parameter callable that is called on each block of data after it is sent. "
 "*rest* means the same thing as in the :meth:`transfercmd` method."
 msgstr ""
+"バイナリ転送モードでファイルを転送します。 *cmd* は適切な ``STOR`` コマン"
+"ド： ``\"STOR filename\"`` でなければなりません。 *fp* は (バイナリモードで開"
+"かれた) :term:`ファイルオブジェクト <file object>` で、 :meth:`~io.IOBase."
+"read` メソッドで EOFまで読み込まれ、ブロックサイズ *blocksize* でデータが転送"
+"されます。引数 *blocksize* のデフォルト値は8192です。 *callback* はオプション"
+"の引数で、引数を1つとる呼び出し可能オブジェクトを渡します。各データブロックが"
+"送信された後に、そのブロックを引数にして呼び出されます。 *rest* は、 :meth:"
+"`transfercmd` メソッドにあるものと同じ意味です。"
 
 #: ../../library/ftplib.rst:298
 msgid "*rest* parameter added."
 
@@ -730,6 +730,10 @@ msgid ""
 "method.  Otherwise, when *n* is 1 *singular* is returned, and *plural* is "
 "returned in all other cases."
 msgstr ""
+"*context* に対するメッセージ id がカタログ中に見つからず、フォールバックオブ"
+"ジェクトが指定されている場合、メッセージ検索要求はフォールバックオブジェクト"
+"の :meth:`npgettext` メソッドに転送されます。そうでない場合、 *n* が 1 なら"
+"ば *singular* が返され、それ以外に対しては *plural* が返されます。"
 
 #: ../../library/gettext.rst:456
 msgid ""
@@ -861,6 +865,16 @@ msgid ""
 "available as part of his `po-utils package <https://github.com/pinard/po-"
 "utils>`__."
 msgstr ""
+"翻訳対象の文字列を抽出するツールもあります。\n"
+"オリジナルの GNU :program:`gettext` は C と C++ のソースコードしかサポートし"
+"ませんが、拡張版の :program:`xgettext` は Python を含めた多くの言語で書かれた"
+"コードを読み取り、翻訳できる文字列を発見します。\n"
+"`Babel <https://babel.pocoo.org/>`__ は Python の国際化ライブラリで、翻訳文字"
+"列の抽出とメッセージカタログのコンパイルを行う :file:`pybabel` スクリプトがあ"
+"ります。\n"
+"François Pinard が開発した :program:`xpot` と呼ばれるプログラムは同じような処"
+"理を行え、彼の `po-utils package <https://github.com/pinard/po-utils>`__ の一"
+"部として利用可能です。"
 
 #: ../../library/gettext.rst:537
 msgid ""