sync with cpython 8f412116

github-actions[bot] · web-flow · commit 683fcd03d4e7 · 2025-07-26T00:18:50.000Z
diff --git a/library/asyncio-queue.po b/library/asyncio-queue.po
@@ -8,7 +8,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.13\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2025-07-25 00:16+0000\n"
+"POT-Creation-Date: 2025-07-26 00:17+0000\n"
 "PO-Revision-Date: 2022-02-20 18:34+0800\n"
 "Last-Translator: Matt Wang <mattwang44@gmail.com>\n"
 "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -193,24 +193,25 @@ msgstr ""
 #: ../../library/asyncio-queue.rst:122
 msgid ""
 "If *immediate* is true, the queue is terminated immediately. The queue is "
-"drained to be completely empty.  All callers of :meth:`~Queue.join` are "
-"unblocked regardless of the number of unfinished tasks.  Blocked callers of :"
-"meth:`~Queue.get` are unblocked and will raise :exc:`QueueShutDown` because "
-"the queue is empty."
+"drained to be completely empty and the count of unfinished tasks is reduced "
+"by the number of tasks drained. If unfinished tasks is zero, callers of :"
+"meth:`~Queue.join` are unblocked.  Also, blocked callers of :meth:`~Queue."
+"get` are unblocked and will raise :exc:`QueueShutDown` because the queue is "
+"empty."
 msgstr ""
 
-#: ../../library/asyncio-queue.rst:129
+#: ../../library/asyncio-queue.rst:130
 msgid ""
 "Use caution when using :meth:`~Queue.join` with *immediate* set to true. "
 "This unblocks the join even when no work has been done on the tasks, "
 "violating the usual invariant for joining a queue."
 msgstr ""
 
-#: ../../library/asyncio-queue.rst:137
+#: ../../library/asyncio-queue.rst:138
 msgid "Indicate that a formerly enqueued work item is complete."
 msgstr "表示前面一個排隊的工作項目已經完成。"
 
-#: ../../library/asyncio-queue.rst:139
+#: ../../library/asyncio-queue.rst:140
 msgid ""
 "Used by queue consumers. For each :meth:`~Queue.get` used to fetch a work "
 "item, a subsequent call to :meth:`task_done` tells the queue that the "
@@ -219,7 +220,7 @@ msgstr ""
 "由佇列消耗者使用。對於每個用於取得一個工作項目的 :meth:`~Queue.get`，接續的 :"
 "meth:`task_done` 呼叫會告訴佇列這個工作項目的處理已經完成。"
 
-#: ../../library/asyncio-queue.rst:143
+#: ../../library/asyncio-queue.rst:144
 msgid ""
 "If a :meth:`join` is currently blocking, it will resume when all items have "
 "been processed (meaning that a :meth:`task_done` call was received for every "
@@ -228,70 +229,70 @@ msgstr ""
 "如果 :meth:`join` 目前正在阻塞，在所有項目都被處理後會解除阻塞（意味著每個"
 "以 :meth:`~Queue.put` 放進佇列的條目都會收到一個 :meth:`task_done`）。"
 
-#: ../../library/asyncio-queue.rst:148
+#: ../../library/asyncio-queue.rst:149
 msgid ""
 "Raises :exc:`ValueError` if called more times than there were items placed "
 "in the queue."
 msgstr "如果被呼叫的次數多於放入佇列中的項目數量，將引發 :exc:`ValueError`。"
 
-#: ../../library/asyncio-queue.rst:153
+#: ../../library/asyncio-queue.rst:154
 msgid "Priority Queue"
 msgstr "Priority Queue（優先佇列）"
 
-#: ../../library/asyncio-queue.rst:157
+#: ../../library/asyncio-queue.rst:158
 msgid ""
 "A variant of :class:`Queue`; retrieves entries in priority order (lowest "
 "first)."
 msgstr ":class:`Queue` 的變形；按優先順序取出條目 (最小的先取出)。"
 
-#: ../../library/asyncio-queue.rst:160
+#: ../../library/asyncio-queue.rst:161
 msgid "Entries are typically tuples of the form ``(priority_number, data)``."
 msgstr "條目通常是 ``(priority_number, data)`` 形式的 tuple（元組）。"
 
-#: ../../library/asyncio-queue.rst:165
+#: ../../library/asyncio-queue.rst:166
 msgid "LIFO Queue"
 msgstr "LIFO Queue"
 
-#: ../../library/asyncio-queue.rst:169
+#: ../../library/asyncio-queue.rst:170
 msgid ""
 "A variant of :class:`Queue` that retrieves most recently added entries first "
 "(last in, first out)."
 msgstr ":class:`Queue` 的變形，先取出最近新增的條目（後進先出）。"
 
-#: ../../library/asyncio-queue.rst:174
+#: ../../library/asyncio-queue.rst:175
 msgid "Exceptions"
 msgstr "例外"
 
-#: ../../library/asyncio-queue.rst:178
+#: ../../library/asyncio-queue.rst:179
 msgid ""
 "This exception is raised when the :meth:`~Queue.get_nowait` method is called "
 "on an empty queue."
 msgstr "當佇列為空的時候，呼叫 :meth:`~Queue.get_nowait` 方法會引發這個例外。"
 
-#: ../../library/asyncio-queue.rst:184
+#: ../../library/asyncio-queue.rst:185
 msgid ""
 "Exception raised when the :meth:`~Queue.put_nowait` method is called on a "
 "queue that has reached its *maxsize*."
 msgstr ""
 "當佇列中條目數量已經達到它的 *maxsize* 時，呼叫 :meth:`~Queue.put_nowait` 方"
 "法會引發這個例外。"
 
-#: ../../library/asyncio-queue.rst:190
+#: ../../library/asyncio-queue.rst:191
 msgid ""
 "Exception raised when :meth:`~Queue.put` or :meth:`~Queue.get` is called on "
 "a queue which has been shut down."
 msgstr ""
 
-#: ../../library/asyncio-queue.rst:197
+#: ../../library/asyncio-queue.rst:198
 msgid "Examples"
 msgstr "範例"
 
-#: ../../library/asyncio-queue.rst:201
+#: ../../library/asyncio-queue.rst:202
 msgid ""
 "Queues can be used to distribute workload between several concurrent tasks::"
 msgstr "佇列能被用於多個並行任務的工作分配："
 
-#: ../../library/asyncio-queue.rst:204
+#: ../../library/asyncio-queue.rst:205
 msgid ""
 "import asyncio\n"
 "import random\n"
diff --git a/library/queue.po b/library/queue.po
@@ -10,7 +10,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.13\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2025-07-25 00:16+0000\n"
+"POT-Creation-Date: 2025-07-26 00:17+0000\n"
 "PO-Revision-Date: 2022-09-27 00:12+0800\n"
 "Last-Translator: Allen Wu <allen91.wu@gmail.com>\n"
 "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -250,7 +250,7 @@ msgstr ""
 msgid "Equivalent to ``put(item, block=False)``."
 msgstr "等效於 ``put(item, block=False)``。"
 
-#: ../../library/queue.rst:156 ../../library/queue.rst:313
+#: ../../library/queue.rst:156 ../../library/queue.rst:314
 msgid ""
 "Remove and return an item from the queue.  If optional args *block* is true "
 "and *timeout* is ``None`` (the default), block if necessary until an item is "
@@ -284,7 +284,7 @@ msgid ""
 "the queue has been shut down immediately."
 msgstr ""
 
-#: ../../library/queue.rst:174 ../../library/queue.rst:323
+#: ../../library/queue.rst:174 ../../library/queue.rst:324
 msgid "Equivalent to ``get(False)``."
 msgstr "等效於 ``get(False)``。"
 
@@ -412,36 +412,36 @@ msgstr ""
 #: ../../library/queue.rst:258
 msgid ""
 "If *immediate* is true, the queue is terminated immediately. The queue is "
-"drained to be completely empty.  All callers of :meth:`~Queue.join` are "
-"unblocked regardless of the number of unfinished tasks.  Blocked callers of :"
-"meth:`~Queue.get` are unblocked and will raise :exc:`ShutDown` because the "
-"queue is empty."
+"drained to be completely empty and the count of unfinished tasks is reduced "
+"by the number of tasks drained. If unfinished tasks is zero, callers of :"
+"meth:`~Queue.join` are unblocked.  Also, blocked callers of :meth:`~Queue."
+"get` are unblocked and will raise :exc:`ShutDown` because the queue is empty."
 msgstr ""
 
-#: ../../library/queue.rst:265
+#: ../../library/queue.rst:266
 msgid ""
 "Use caution when using :meth:`~Queue.join` with *immediate* set to true. "
 "This unblocks the join even when no work has been done on the tasks, "
 "violating the usual invariant for joining a queue."
 msgstr ""
 
-#: ../../library/queue.rst:273
+#: ../../library/queue.rst:274
 msgid "SimpleQueue Objects"
 msgstr "SimpleQueue 物件"
 
-#: ../../library/queue.rst:275
+#: ../../library/queue.rst:276
 msgid ""
 ":class:`SimpleQueue` objects provide the public methods described below."
 msgstr ":class:`SimpleQueue` 物件提供下面描述的公用 method。"
 
-#: ../../library/queue.rst:279
+#: ../../library/queue.rst:280
 msgid ""
 "Return the approximate size of the queue.  Note, qsize() > 0 doesn't "
 "guarantee that a subsequent get() will not block."
 msgstr ""
 "傳回佇列的近似大小。注意，qsize() > 0 並不能保證後續的 get() 不會阻塞。"
 
-#: ../../library/queue.rst:285
+#: ../../library/queue.rst:286
 msgid ""
 "Return ``True`` if the queue is empty, ``False`` otherwise.  If empty() "
 "returns ``False`` it doesn't guarantee that a subsequent call to get() will "
@@ -450,7 +450,7 @@ msgstr ""
 "如果佇列為空，則回傳 ``True``，否則回傳 ``False``。如果 empty() 回傳 "
 "``False``，則不保證後續呼叫 get() 不會阻塞。"
 
-#: ../../library/queue.rst:292
+#: ../../library/queue.rst:293
 msgid ""
 "Put *item* into the queue.  The method never blocks and always succeeds "
 "(except for potential low-level errors such as failure to allocate memory). "
@@ -461,7 +461,7 @@ msgstr ""
 "像是分配記憶體失敗）。可選的 args *block* 和 *timeout* 會被忽略，它們僅是為了"
 "與 :meth:`Queue.put` 相容才存在。"
 
-#: ../../library/queue.rst:298
+#: ../../library/queue.rst:299
 msgid ""
 "This method has a C implementation which is reentrant.  That is, a ``put()`` "
 "or ``get()`` call can be interrupted by another ``put()`` call in the same "
@@ -474,26 +474,26 @@ msgstr ""
 "鎖 (deadlock) 或損壞佇列中的內部狀態。這使得它適合在解構子 (destructor) 中使"
 "用，像是 ``__del__`` method 或 :mod:`weakref` 回呼函式 (callback)。"
 
-#: ../../library/queue.rst:307
+#: ../../library/queue.rst:308
 msgid ""
 "Equivalent to ``put(item, block=False)``, provided for compatibility with :"
 "meth:`Queue.put_nowait`."
 msgstr ""
 "等效於 ``put(item, block=False)``，用於與 :meth:`Queue.put_nowait` 相容。"
 
-#: ../../library/queue.rst:328
+#: ../../library/queue.rst:329
 msgid "Class :class:`multiprocessing.Queue`"
 msgstr "Class :class:`multiprocessing.Queue`"
 
-#: ../../library/queue.rst:329
+#: ../../library/queue.rst:330
 msgid ""
 "A queue class for use in a multi-processing (rather than multi-threading) "
 "context."
 msgstr ""
 "用於多行程處理 (multi-processing)（而非多執行緒）情境 (context) 的佇列 "
 "class。"
 
-#: ../../library/queue.rst:332
+#: ../../library/queue.rst:333
 msgid ""
 ":class:`collections.deque` is an alternative implementation of unbounded "
 "queues with fast atomic :meth:`~collections.deque.append` and :meth:"
