sync with cpython 0f529b1c

Author: github-actions[bot]

library/asyncio-graph.po

@@ -7,7 +7,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.14\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2025-09-08 15:25+0800\n"
+"POT-Creation-Date: 2026-07-09 00:32+0000\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -18,7 +18,8 @@ msgstr ""
 "Content-Transfer-Encoding: 8bit\n"
 
 #: ../../library/asyncio-graph.rst:8
-msgid "Call Graph Introspection"
+#, fuzzy
+msgid "Call graph introspection"
 msgstr "呼叫圖內省（Call Graph Introspection）"
 
 #: ../../library/asyncio-graph.rst:10
@@ -32,40 +33,49 @@ msgid ""
 "*future*.  These utilities and the underlying machinery can be used from "
 "within a Python program or by external profilers and debuggers."
 msgstr ""
-"asyncio 擁有強大的 runtime 呼叫圖內省工具，可以追蹤執行中的\\ *協程*\\ 或\\ "
-"*任務*，或是暫停的 *future* 的完整呼叫圖。這些工具和底層機制可以在 "
-"Python 程式內部使用，或被外部分析器和偵錯器使用。"
+"asyncio 擁有強大的 runtime 呼叫圖內省工具，可以追蹤執行中的\\ *協程*\\ 或\\ *"
+"任務*，或是暫停的 *future* 的完整呼叫圖。這些工具和底層機制可以在 Python 程式"
+"內部使用，或被外部分析器和偵錯器使用。"
+
+#: ../../library/asyncio-graph.rst:22
+msgid ":ref:`asyncio-introspection-tools`"
+msgstr ""
 
-#: ../../library/asyncio-graph.rst:25
+#: ../../library/asyncio-graph.rst:23
+msgid ""
+"Command-line tools for inspecting tasks in another running Python process."
+msgstr ""
+
+#: ../../library/asyncio-graph.rst:31
 msgid ""
-"Print the async call graph for the current task or the "
-"provided :class:`Task` or :class:`Future`."
+"Print the async call graph for the current task or the provided :class:"
+"`Task` or :class:`Future`."
 msgstr ""
 "印出目前任務或所提供的 :class:`Task` 或 :class:`Future` 的非同步呼叫圖。"
 
-#: ../../library/asyncio-graph.rst:28
+#: ../../library/asyncio-graph.rst:34
 msgid ""
 "This function prints entries starting from the top frame and going down "
 "towards the invocation point."
 msgstr "此函式會從頂層 frame 開始印出條目，然後往下到呼叫點。"
 
-#: ../../library/asyncio-graph.rst:31
+#: ../../library/asyncio-graph.rst:37
 msgid ""
 "The function receives an optional *future* argument. If not passed, the "
 "current running task will be used."
 msgstr ""
 "此函式接受一個選擇性的 *future* 引數。如果未傳入，將使用目前執行中的任務。"
 
-#: ../../library/asyncio-graph.rst:34 ../../library/asyncio-graph.rst:93
+#: ../../library/asyncio-graph.rst:40 ../../library/asyncio-graph.rst:99
 msgid ""
 "If the function is called on *the current task*, the optional keyword-only "
 "*depth* argument can be used to skip the specified number of frames from top "
 "of the stack."
 msgstr ""
-"如果在\\ *目前任務*\\ 上呼叫此函式，可以使用選擇性的僅限關鍵字引數 *depth* "
-"來跳過堆疊頂端指定數量的 frame。"
+"如果在\\ *目前任務*\\ 上呼叫此函式，可以使用選擇性的僅限關鍵字引數 *depth* 來"
+"跳過堆疊頂端指定數量的 frame。"
 
-#: ../../library/asyncio-graph.rst:38
+#: ../../library/asyncio-graph.rst:44
 msgid ""
 "If the optional keyword-only *limit* argument is provided, each call stack "
 "in the resulting graph is truncated to include at most ``abs(limit)`` "
@@ -75,28 +85,27 @@ msgid ""
 "``0``, the call stack is not printed at all, only \"awaited by\" information "
 "is printed."
 msgstr ""
-"如果提供了選擇性的僅限關鍵字引數 *limit*，結果圖中的每個呼叫堆疊會被截斷"
-"為最多包含 ``abs(limit)`` 個條目。如果 *limit* 為正數，保留的條目是最接近呼"
-"叫點的。如果 *limit* 為負數，保留最頂層的條目。如果 *limit* 被省略或為 "
-"``None``，則顯示所有條目。如果 *limit* 為 ``0``，則完全不印出呼叫堆"
-"疊，只印出「awaited by」資訊。"
+"如果提供了選擇性的僅限關鍵字引數 *limit*，結果圖中的每個呼叫堆疊會被截斷為最"
+"多包含 ``abs(limit)`` 個條目。如果 *limit* 為正數，保留的條目是最接近呼叫點"
+"的。如果 *limit* 為負數，保留最頂層的條目。如果 *limit* 被省略或為 ``None``，"
+"則顯示所有條目。如果 *limit* 為 ``0``，則完全不印出呼叫堆疊，只印出「awaited "
+"by」資訊。"
 
-#: ../../library/asyncio-graph.rst:46
+#: ../../library/asyncio-graph.rst:52
 msgid ""
-"If *file* is omitted or ``None``, the function will print "
-"to :data:`sys.stdout`."
-msgstr ""
-"如果 *file* 被省略或為 ``None``，此函式將印出到 :data:`sys.stdout`。"
+"If *file* is omitted or ``None``, the function will print to :data:`sys."
+"stdout`."
+msgstr "如果 *file* 被省略或為 ``None``，此函式將印出到 :data:`sys.stdout`。"
 
-#: ../../library/asyncio-graph.rst:49
+#: ../../library/asyncio-graph.rst:55
 msgid "**Example:**"
 msgstr "**範例：**"
 
-#: ../../library/asyncio-graph.rst:51
+#: ../../library/asyncio-graph.rst:57
 msgid "The following Python code:"
 msgstr "以下 Python 程式碼："
 
-#: ../../library/asyncio-graph.rst:53
+#: ../../library/asyncio-graph.rst:59
 msgid ""
 "import asyncio\n"
 "\n"
@@ -120,11 +129,11 @@ msgstr ""
 "\n"
 "asyncio.run(main())"
 
-#: ../../library/asyncio-graph.rst:66
+#: ../../library/asyncio-graph.rst:72
 msgid "will print::"
 msgstr "會印出： ::"
 
-#: ../../library/asyncio-graph.rst:68
+#: ../../library/asyncio-graph.rst:74
 msgid ""
 "* Task(name='test', id=0x1039f0fe0)\n"
 "+ Call stack:\n"
@@ -144,98 +153,97 @@ msgstr ""
 "      |   File 'taskgroups.py', line 107, in async TaskGroup.__aexit__()\n"
 "      |   File 't2.py', line 7, in async main()"
 
-#: ../../library/asyncio-graph.rst:79
+#: ../../library/asyncio-graph.rst:85
 msgid ""
 "Like :func:`print_call_graph`, but returns a string. If *future* is ``None`` "
 "and there's no current task, the function returns an empty string."
 msgstr ""
-"類似於 :func:`print_call_graph`，但回傳一個字串。如果 *future* 為 "
-"``None`` 且沒有目前任務，此函式回傳一個空字串。"
+"類似於 :func:`print_call_graph`，但回傳一個字串。如果 *future* 為 ``None`` 且"
+"沒有目前任務，此函式回傳一個空字串。"
 
-#: ../../library/asyncio-graph.rst:86
+#: ../../library/asyncio-graph.rst:92
 msgid ""
-"Capture the async call graph for the current task or the "
-"provided :class:`Task` or :class:`Future`."
+"Capture the async call graph for the current task or the provided :class:"
+"`Task` or :class:`Future`."
 msgstr ""
 "捕獲目前任務或所提供的 :class:`Task` 或 :class:`Future` 的非同步呼叫圖。"
 
-#: ../../library/asyncio-graph.rst:89
+#: ../../library/asyncio-graph.rst:95
 msgid ""
 "The function receives an optional *future* argument. If not passed, the "
 "current running task will be used. If there's no current task, the function "
 "returns ``None``."
 msgstr ""
-"此函式接受一個選擇性的 *future* 引數。如果未傳入，將使用目前執行中的任務。"
-"如果沒有目前任務，此函式回傳 ``None``。"
+"此函式接受一個選擇性的 *future* 引數。如果未傳入，將使用目前執行中的任務。如"
+"果沒有目前任務，此函式回傳 ``None``。"
 
-#: ../../library/asyncio-graph.rst:97
+#: ../../library/asyncio-graph.rst:103
 msgid "Returns a ``FutureCallGraph`` data class object:"
 msgstr "會回傳一個 ``FutureCallGraph`` 資料類別物件："
 
-#: ../../library/asyncio-graph.rst:99
+#: ../../library/asyncio-graph.rst:105
 msgid "``FutureCallGraph(future, call_stack, awaited_by)``"
 msgstr "``FutureCallGraph(future, call_stack, awaited_by)``"
 
-#: ../../library/asyncio-graph.rst:101
+#: ../../library/asyncio-graph.rst:107
 msgid ""
 "Where *future* is a reference to a :class:`Future` or a :class:`Task` (or "
 "their subclasses.)"
 msgstr ""
-"其中 *future* 是對 :class:`Future` 或 :class:`Task`\\ （或它們的子類別）的"
-"參照。"
+"其中 *future* 是對 :class:`Future` 或 :class:`Task`\\ （或它們的子類別）的參"
+"照。"
 
-#: ../../library/asyncio-graph.rst:104
+#: ../../library/asyncio-graph.rst:110
 msgid "``call_stack`` is a tuple of ``FrameCallGraphEntry`` objects."
 msgstr "``call_stack`` 是一個由 ``FrameCallGraphEntry`` 物件組成的元組。"
 
-#: ../../library/asyncio-graph.rst:106
+#: ../../library/asyncio-graph.rst:112
 msgid "``awaited_by`` is a tuple of ``FutureCallGraph`` objects."
 msgstr "``awaited_by`` 是一個由 ``FutureCallGraph`` 物件組成的元組。"
 
-#: ../../library/asyncio-graph.rst:108
+#: ../../library/asyncio-graph.rst:114
 msgid "``FrameCallGraphEntry(frame)``"
 msgstr "``FrameCallGraphEntry(frame)``"
 
-#: ../../library/asyncio-graph.rst:110
+#: ../../library/asyncio-graph.rst:116
 msgid ""
 "Where *frame* is a frame object of a regular Python function in the call "
 "stack."
 msgstr "其中 *frame* 是呼叫堆疊中常規 Python 函式的 frame 物件。"
 
-#: ../../library/asyncio-graph.rst:115
+#: ../../library/asyncio-graph.rst:121
 msgid "Low level utility functions"
 msgstr "低階工具函式"
 
-#: ../../library/asyncio-graph.rst:117
+#: ../../library/asyncio-graph.rst:123
 msgid ""
 "To introspect an async call graph asyncio requires cooperation from control "
 "flow structures, such as :func:`shield` or :class:`TaskGroup`. Any time an "
-"intermediate :class:`Future` object with low-level APIs "
-"like :meth:`Future.add_done_callback() <asyncio.Future.add_done_callback>` "
-"is involved, the following two functions should be used to inform asyncio "
-"about how exactly such intermediate future objects are connected with the "
-"tasks they wrap or control."
+"intermediate :class:`Future` object with low-level APIs like :meth:`Future."
+"add_done_callback() <asyncio.Future.add_done_callback>` is involved, the "
+"following two functions should be used to inform asyncio about how exactly "
+"such intermediate future objects are connected with the tasks they wrap or "
+"control."
 msgstr ""
 "要內省非同步呼叫圖，asyncio 需要來自控制流程結構的協作，例如 :func:`shield` "
 "或 :class:`TaskGroup`。任何時候涉及使用低階 API（如 :meth:`Future."
 "add_done_callback() <asyncio.Future.add_done_callback>`）的中介 :class:"
-"`Future` 物件時，應使用以下兩個函式來告知 asyncio 這些中介 future 物件如何"
-"與它們所包裝或控制的任務連接。"
+"`Future` 物件時，應使用以下兩個函式來告知 asyncio 這些中介 future 物件如何與"
+"它們所包裝或控制的任務連接。"
 
-#: ../../library/asyncio-graph.rst:128
+#: ../../library/asyncio-graph.rst:134
 msgid "Record that *future* is awaited on by *waiter*."
 msgstr "記錄 *future* 正被 *waiter* 等待。"
 
-#: ../../library/asyncio-graph.rst:130 ../../library/asyncio-graph.rst:143
+#: ../../library/asyncio-graph.rst:136 ../../library/asyncio-graph.rst:149
 msgid ""
-"Both *future* and *waiter* must be instances of :class:`Future` "
-"or :class:`Task` or their subclasses, otherwise the call would have no "
-"effect."
+"Both *future* and *waiter* must be instances of :class:`Future` or :class:"
+"`Task` or their subclasses, otherwise the call would have no effect."
 msgstr ""
-"*future* 和 *waiter* 都必須是 :class:`Future` 或 :class:`Task` 或它們子類別"
-"的實例，否則呼叫將不會產生任何效果。"
+"*future* 和 *waiter* 都必須是 :class:`Future` 或 :class:`Task` 或它們子類別的"
+"實例，否則呼叫將不會產生任何效果。"
 
-#: ../../library/asyncio-graph.rst:134
+#: ../../library/asyncio-graph.rst:140
 msgid ""
 "A call to ``future_add_to_awaited_by()`` must be followed by an eventual "
 "call to the :func:`future_discard_from_awaited_by` function with the same "
@@ -244,6 +252,6 @@ msgstr ""
 "對 ``future_add_to_awaited_by()`` 的呼叫必須最終跟隨一個對 :func:"
 "`future_discard_from_awaited_by` 函式的呼叫，並使用相同的引數。"
 
-#: ../../library/asyncio-graph.rst:141
+#: ../../library/asyncio-graph.rst:147
 msgid "Record that *future* is no longer awaited on by *waiter*."
 msgstr "記錄 *future* 不再被 *waiter* 等待。"