Merge 3.11 into 3.10

github-actions · github-actions · commit 8966a041d7c8 · 2023-02-12T23:50:35.000Z
diff --git a/library/logging.po b/library/logging.po
@@ -72,14 +72,17 @@ msgstr ""
 
 #: ../../library/logging.rst:33
 msgid "The simplest example:"
-msgstr ""
+msgstr "もっとも単純な例:"
 
 #: ../../library/logging.rst:41
 msgid ""
 "The module provides a lot of functionality and flexibility.  If you are "
 "unfamiliar with logging, the best way to get to grips with it is to view the "
 "tutorials (**see the links above and on the right**)."
 msgstr ""
+"このモジュールは、多くの機能性と柔軟性を提供します。ロギングに慣れていないな"
+"ら、使い方を理解する最良の方法はチュートリアルを読むことです (**右上のリンク"
+"を参照してください**)。"
 
 #: ../../library/logging.rst:45
 msgid ""
@@ -185,6 +188,14 @@ msgid ""
 "false, then that is the last logger whose handlers are offered the event to "
 "handle, and propagation stops at that point."
 msgstr ""
+"具体的な例で説明します: ``A.B.C`` という名前のロガーの propagate 属性が真と評"
+"価された場合、 ``logging.getLogger('A.B.C').error(...)`` のようなメソッドの呼"
+"び出しを通じて ``A.B.C`` に記録された全てのイベントは、 [ログレベルとフィルタ"
+"の設定を満たした場合に限り] 最初に ``A.B.C`` に接続されたハンドラに渡され、そ"
+"の後 ``A.B``, ``A`` という名前のロガー、そしてルートロガーという順番で各ロ"
+"ガーに接続されたハンドラに渡されます。この連鎖構造において ``A.B.C``, ``A."
+"B``, ``A`` のいずれかの ``propagate`` 属性が偽に設定された場合、そのロガーが"
+"イベントを処理する最後のロガーとなり、その時点でイベントの伝播は止まります。"
 
 #: ../../library/logging.rst:100
 msgid "The constructor sets this attribute to ``True``."
@@ -434,6 +445,9 @@ msgid ""
 "used by the logging system. (See the section on :ref:`logrecord-attributes` "
 "for more information on which keys are used by the logging system.)"
 msgstr ""
+"*extra* に渡される辞書のキーはロギングシステムで使われているものと衝突しては"
+"いけません。 (ロギングシステムが使うキーの詳細については :ref:`logrecord-"
+"attributes` の節を参照してください。)"
 
 #: ../../library/logging.rst:239
 msgid ""
@@ -476,6 +490,9 @@ msgid ""
 "into account the relevant :attr:`Logger.propagate` attributes), the message "
 "will be sent to the handler set on :attr:`lastResort`."
 msgstr ""
+"このロガー (および :attr:`Logger.propagate` 属性を考慮した上で実効的にイベン"
+"トが伝播する祖先のロガー) にハンドラが接続されていない場合、メッセージは :"
+"attr:`lastResort` に設定されたハンドラーに送られます。"
 
 #: ../../library/logging.rst:257 ../../library/logging.rst:1125
 msgid "The *stack_info* parameter was added."
@@ -884,12 +901,19 @@ msgid ""
 "logging API which might do locking, because that might result in a deadlock. "
 "Specifically:"
 msgstr ""
+"このメソッドはハンドラレベルのロックを取得した後で呼び出されます。また、ロッ"
+"クはこのメソッドがリターンした後で解放されます。このメソッドをオーバーライド"
+"する場合、ロックを取得する可能性のある logging API の他の関数やメソッドの呼び"
+"出しに注意してください。そのような実装はデッドロックを引き起こす可能性があり"
+"ます。特に以下の点に注意してください:"
 
 #: ../../library/logging.rst:531
 msgid ""
 "Logging configuration APIs acquire the module-level lock, and then "
 "individual handler-level locks as those handlers are configured."
 msgstr ""
+"ロギングを構成するための API はモジュールレベルのロックを取得し、その後ハンド"
+"ラを構成する際に個々のハンドラに対してハンドラレベルのロックを取得します。"
 
 #: ../../library/logging.rst:534
 msgid ""
@@ -900,6 +924,13 @@ msgid ""
 "the module-level lock *after* the handler-level lock (because in this "
 "method, the handler-level lock has already been acquired)."
 msgstr ""
+"多くのロギング API はモジュールレベルのロックを取得します。そのような API が"
+"このメソッドから呼ばれた場合、他のスレッドからロギングを構成するための API 呼"
+"び出しが行われたときにデッドロックに陥る可能性があります。これは他のスレッド"
+"がハンドラレベルのロックを取得する *前に* モジュールレベルのロックを取得しよ"
+"うとする一方で、 (このメソッドはハンドラレベルのロックが既に取得された状態で"
+"呼び出されているため) このメソッドを呼び出したスレッドはハンドラレベルのロッ"
+"クを取得した *後で* モジュールレベルのロックを取得しようとするためです。 "
 
 #: ../../library/logging.rst:541
 msgid ""
@@ -1151,6 +1182,11 @@ msgid ""
 "specified, the default formatter (which just outputs the event message) is "
 "used as the line formatter."
 msgstr ""
+"複数のレコードをまとめてフォーマットしたい場合のクラス定義に適した基底クラス"
+"です。各行 (単一のレコードに相当します) をフォーマットするために使う :class:"
+"`Formatter` インスタンスを渡すことができます。特に指定がない場合はデフォルト"
+"のフォーマッタ (イベントのメッセージだけを出力するフォーマッタ) が使われま"
+"す。"
 
 #: ../../library/logging.rst:681
 msgid ""
@@ -1159,13 +1195,20 @@ msgid ""
 "specific behaviour, e.g. to show the count of records, a title or a "
 "separator line."
 msgstr ""
+"*複数のレコード* のリストに対するヘッダを返します。基底クラスの実装は単に空の"
+"文字列を返すだけです。レコード数やタイトルを表示したり、あるいはセパレータ行"
+"したいなど、ヘッダに対して特別な振る舞いが必要な場合はこのメソッドをオーバー"
+"ライドする必要があります。"
 
 #: ../../library/logging.rst:688
 msgid ""
 "Return a footer for a list of *records*. The base implementation just "
 "returns the empty string. You will need to override this method if you want "
 "specific behaviour, e.g. to show the count of records or a separator line."
 msgstr ""
+"*複数のレコード* のリストに対するフッタを返します。基底クラスの実装は単に空の"
+"文字列を返すだけです。レコード数やセパレータ行の表示など、フッタに対して特別"
+"な振る舞いが必要な場合はこのメソッドをオーバーライドする必要があります。"
 
 #: ../../library/logging.rst:695
 msgid ""
@@ -1174,6 +1217,10 @@ msgid ""
 "concatenation of the header, each record formatted with the line formatter, "
 "and the footer."
 msgstr ""
+"*複数のレコード* のリストに対するフォーマット済みテキストを返します。基底クラ"
+"スの実装は、レコードがなければ空の文字列を返し、レコードがある場合はヘッダ、"
+"単一のレコードをフォーマットするためのラインフォーマッタで各レコードをフォー"
+"マットした文字列、そしてフッタを全て連結したものを返します。"
 
 #: ../../library/logging.rst:703
 msgid "Filter Objects"
@@ -1303,6 +1350,8 @@ msgid ""
 "The primary information is passed in *msg* and *args*, which are combined "
 "using ``msg % args`` to create the :attr:`!message` attribute of the record."
 msgstr ""
+"もっとも重要な情報は *msg* と *args* に渡され、 ``msg % args`` で結合されてレ"
+"コードの :attr:`!message` 属性を生成します。"
 
 #: ../../library/logging.rst:0
 msgid "Parameters"
@@ -1315,6 +1364,9 @@ msgid ""
 "have this value, even though it may be emitted by a handler attached to a "
 "different (ancestor) logger."
 msgstr ""
+"この :class:`!LogRecord` であらわされるイベントを記録したロガーの名前です。 :"
+"class:`!LogRecord` が持つロガーの名前は、たとえ異なる (祖先の) ロガーに接続さ"
+"れたハンドラから出力されたとしても、常に同じ値を持つことに注意してください。"
 
 #: ../../library/logging.rst:783
 msgid ""
@@ -1323,11 +1375,17 @@ msgid ""
 "attributes of the LogRecord: :attr:`!levelno` for the numeric value and :"
 "attr:`!levelname` for the corresponding level name."
 msgstr ""
+"記録されたイベントの :ref:`数値であらわしたロギングレベル <levels>`  (``10`` "
+"が ``DEBUG``, ``20`` が ``INFO`` など) です。このパラメータは LogRecord の *2"
+"つの* 属性に変換されることに注意してください: 数値は :attr:`!levelno` に、ま"
+"た対応するログレベルの名前は :attr:`!levelname` に保持されます。"
 
 #: ../../library/logging.rst:790
 msgid ""
 "The full string path of the source file where the logging call was made."
 msgstr ""
+"ロギングの呼び出しが行われたソースファイルへの完全なパス名をあらわす文字列で"
+"す。"
 
 #: ../../library/logging.rst:794
 msgid "The line number in the source file where the logging call was made."
@@ -1338,6 +1396,8 @@ msgid ""
 "The event description message, which can be a %-format string with "
 "placeholders for variable data."
 msgstr ""
+"イベントを記述するメッセージです。変数データのプレースホルダを伴う %-f 形式の"
+"書式文字列のこともあります。"
 
 #: ../../library/logging.rst:802
 msgid ""
@@ -1350,6 +1410,8 @@ msgid ""
 "An exception tuple with the current exception information, as returned by :"
 "func:`sys.exc_info`, or ``None`` if no exception information is available."
 msgstr ""
+":func:`sys.exc_info` によって返される現在の例外情報を含む例外タプルです。例外"
+"情報がない場合は ``None`` です。"
 
 #: ../../library/logging.rst:811
 msgid ""
@@ -2013,6 +2075,9 @@ msgid ""
 "func:`critical`) will call :func:`basicConfig` if the root logger doesn't "
 "have any handler attached."
 msgstr ""
+"ルートロガーにハンドラが接続されていない場合、この関数 (および :func:"
+"`info`, :func:`warning`, :func:`error` そして :func:`critical`) は :func:"
+"`basicConfig` を呼び出します。"
 
 #: ../../library/logging.rst:1130
 msgid ""
@@ -2658,6 +2723,8 @@ msgid ""
 "`Original Python logging package <https://old.red-dove.com/python_logging."
 "html>`_"
 msgstr ""
+"`Python の最初のロギングパッケージ <https://old.red-dove.com/python_logging."
+"html>`_"
 
 #: ../../library/logging.rst:1443
 msgid ""
