sync with cpython 709041c3

Author: github-actions[bot]

library/asyncio-stream.po

@@ -8,7 +8,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.14\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2025-10-05 00:16+0000\n"
+"POT-Creation-Date: 2026-08-05 00:29+0000\n"
 "PO-Revision-Date: 2022-10-31 16:28+0800\n"
 "Last-Translator: Matt Wang <mattwang44@gmail.com>\n"
 "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -42,7 +42,7 @@ msgstr ""
 msgid "Here is an example of a TCP echo client written using asyncio streams::"
 msgstr "這是一個使用 asyncio 串流編寫的 TCP echo 用戶端範例： ::"
 
-#: ../../library/asyncio-stream.rst:22 ../../library/asyncio-stream.rst:441
+#: ../../library/asyncio-stream.rst:22 ../../library/asyncio-stream.rst:451
 msgid ""
 "import asyncio\n"
 "\n"
@@ -146,7 +146,7 @@ msgstr "移除 *loop* 參數。"
 
 #: ../../library/asyncio-stream.rst:87 ../../library/asyncio-stream.rst:131
 #: ../../library/asyncio-stream.rst:167 ../../library/asyncio-stream.rst:202
-#: ../../library/asyncio-stream.rst:408
+#: ../../library/asyncio-stream.rst:418
 msgid "Added the *ssl_shutdown_timeout* parameter."
 msgstr "新增 *ssl_shutdown_timeout* 參數。"
 
@@ -509,48 +509,57 @@ msgstr ""
 "(high watermark) 時，*drain()* 會阻塞直到緩衝區大小減少至最低標記位 (low "
 "watermark) 以便繼續寫入。當沒有要等待的資料時，:meth:`drain` 會立即回傳。"
 
-#: ../../library/asyncio-stream.rst:389
+#: ../../library/asyncio-stream.rst:387
+msgid ""
+"When the write buffer is below the high watermark, :meth:`drain` returns "
+"immediately without yielding to the event loop.  As a result, code which "
+"repeatedly calls ``write()`` followed by ``await drain()`` may prevent other "
+"tasks from running.  To prevent blocking behavior, yield to the event loop "
+"explicitly with ``await asyncio.sleep(0)`` (see :func:`asyncio.sleep`)."
+msgstr ""
+
+#: ../../library/asyncio-stream.rst:399
 msgid "Upgrade an existing stream-based connection to TLS."
 msgstr "將現有的基於串流的連線升級到 TLS。"
 
-#: ../../library/asyncio-stream.rst:391
+#: ../../library/asyncio-stream.rst:401
 msgid "Parameters:"
 msgstr "參數："
 
-#: ../../library/asyncio-stream.rst:393
+#: ../../library/asyncio-stream.rst:403
 msgid "*sslcontext*: a configured instance of :class:`~ssl.SSLContext`."
 msgstr "*sslcontext*：一個 :class:`~ssl.SSLContext` 的已配置實例。"
 
-#: ../../library/asyncio-stream.rst:395
+#: ../../library/asyncio-stream.rst:405
 msgid ""
 "*server_hostname*: sets or overrides the host name that the target server's "
 "certificate will be matched against."
 msgstr "*server_hostname*：設定或覆寫將會被目標伺服器憑證比對的主機名稱。"
 
-#: ../../library/asyncio-stream.rst:398
+#: ../../library/asyncio-stream.rst:408
 msgid ""
 "*ssl_handshake_timeout* is the time in seconds to wait for the TLS handshake "
 "to complete before aborting the connection.  ``60.0`` seconds if ``None`` "
 "(default)."
 msgstr ""
 
-#: ../../library/asyncio-stream.rst:402
+#: ../../library/asyncio-stream.rst:412
 msgid ""
 "*ssl_shutdown_timeout* is the time in seconds to wait for the SSL shutdown "
 "to complete before aborting the connection. ``30.0`` seconds if ``None`` "
 "(default)."
 msgstr ""
 
-#: ../../library/asyncio-stream.rst:414
+#: ../../library/asyncio-stream.rst:424
 msgid ""
 "Return ``True`` if the stream is closed or in the process of being closed."
 msgstr "如果串流已被關閉或正在被關閉則回傳 ``True``。"
 
-#: ../../library/asyncio-stream.rst:422
+#: ../../library/asyncio-stream.rst:432
 msgid "Wait until the stream is closed."
 msgstr "等待直到串流被關閉。"
 
-#: ../../library/asyncio-stream.rst:424
+#: ../../library/asyncio-stream.rst:434
 msgid ""
 "Should be called after :meth:`close` to wait until the underlying connection "
 "is closed, ensuring that all data has been flushed before e.g. exiting the "
@@ -559,19 +568,19 @@ msgstr ""
 "應當在 :meth:`close` 之後才被呼叫，這會持續等待直到底層的連線被關閉，以確保在"
 "這之前（例如在程式退出前）所有資料都已經被清空"
 
-#: ../../library/asyncio-stream.rst:432
+#: ../../library/asyncio-stream.rst:442
 msgid "Examples"
 msgstr "範例"
 
-#: ../../library/asyncio-stream.rst:437
+#: ../../library/asyncio-stream.rst:447
 msgid "TCP echo client using streams"
 msgstr "使用串流的 TCP echo 用戶端"
 
-#: ../../library/asyncio-stream.rst:439
+#: ../../library/asyncio-stream.rst:449
 msgid "TCP echo client using the :func:`asyncio.open_connection` function::"
 msgstr "使用 :func:`asyncio.open_connection` 函式的 TCP echo 用戶端： ::"
 
-#: ../../library/asyncio-stream.rst:463
+#: ../../library/asyncio-stream.rst:473
 msgid ""
 "The :ref:`TCP echo client protocol "
 "<asyncio_example_tcp_echo_client_protocol>` example uses the low-level :meth:"
@@ -580,15 +589,15 @@ msgstr ""
 "使用低階 :meth:`loop.create_connection` 方法的 :ref:`TCP echo 用戶端協定 "
 "<asyncio_example_tcp_echo_client_protocol>`\\ 範例。"
 
-#: ../../library/asyncio-stream.rst:470
+#: ../../library/asyncio-stream.rst:480
 msgid "TCP echo server using streams"
 msgstr "使用串流的 TCP echo 伺服器"
 
-#: ../../library/asyncio-stream.rst:472
+#: ../../library/asyncio-stream.rst:482
 msgid "TCP echo server using the :func:`asyncio.start_server` function::"
 msgstr "TCP echo 伺服器使用 :func:`asyncio.start_server` 函式： ::"
 
-#: ../../library/asyncio-stream.rst:474
+#: ../../library/asyncio-stream.rst:484
 msgid ""
 "import asyncio\n"
 "\n"
@@ -648,7 +657,7 @@ msgstr ""
 "\n"
 "asyncio.run(main())"
 
-#: ../../library/asyncio-stream.rst:506
+#: ../../library/asyncio-stream.rst:516
 msgid ""
 "The :ref:`TCP echo server protocol "
 "<asyncio_example_tcp_echo_server_protocol>` example uses the :meth:`loop."
@@ -657,16 +666,16 @@ msgstr ""
 "使用 :meth:`loop.create_server` 方法的 :ref:`TCP echo 伺服器協定 "
 "<asyncio_example_tcp_echo_server_protocol>` 範例。"
 
-#: ../../library/asyncio-stream.rst:511
+#: ../../library/asyncio-stream.rst:521
 msgid "Get HTTP headers"
 msgstr "取得 HTTP 標頭"
 
-#: ../../library/asyncio-stream.rst:513
+#: ../../library/asyncio-stream.rst:523
 msgid ""
 "Simple example querying HTTP headers of the URL passed on the command line::"
 msgstr "查詢自命令列傳入之 URL 所帶有 HTTP 標頭的簡單範例： ::"
 
-#: ../../library/asyncio-stream.rst:515
+#: ../../library/asyncio-stream.rst:525
 msgid ""
 "import asyncio\n"
 "import urllib.parse\n"
@@ -705,34 +714,34 @@ msgid ""
 "asyncio.run(print_http_headers(url))"
 msgstr ""
 
-#: ../../library/asyncio-stream.rst:552
+#: ../../library/asyncio-stream.rst:562
 msgid "Usage::"
 msgstr "用法： ::"
 
-#: ../../library/asyncio-stream.rst:554
+#: ../../library/asyncio-stream.rst:564
 msgid "python example.py http://example.com/path/page.html"
 msgstr "python example.py http://example.com/path/page.html"
 
-#: ../../library/asyncio-stream.rst:556
+#: ../../library/asyncio-stream.rst:566
 msgid "or with HTTPS::"
 msgstr "或使用 HTTPS： ::"
 
-#: ../../library/asyncio-stream.rst:558
+#: ../../library/asyncio-stream.rst:568
 msgid "python example.py https://example.com/path/page.html"
 msgstr "python example.py https://example.com/path/page.html"
 
-#: ../../library/asyncio-stream.rst:564
+#: ../../library/asyncio-stream.rst:574
 msgid "Register an open socket to wait for data using streams"
 msgstr "註冊一個使用串流來等待資料的開放 socket"
 
-#: ../../library/asyncio-stream.rst:566
+#: ../../library/asyncio-stream.rst:576
 msgid ""
 "Coroutine waiting until a socket receives data using the :func:"
 "`open_connection` function::"
 msgstr ""
 "等待直到 socket 透過使用 :func:`open_connection` 函式接收到資料的協程： ::"
 
-#: ../../library/asyncio-stream.rst:569
+#: ../../library/asyncio-stream.rst:579
 msgid ""
 "import asyncio\n"
 "import socket\n"
@@ -765,7 +774,7 @@ msgid ""
 "asyncio.run(wait_for_data())"
 msgstr ""
 
-#: ../../library/asyncio-stream.rst:601
+#: ../../library/asyncio-stream.rst:611
 msgid ""
 "The :ref:`register an open socket to wait for data using a protocol "
 "<asyncio_example_create_connection>` example uses a low-level protocol and "
@@ -775,7 +784,7 @@ msgstr ""
 "<asyncio_example_create_connection>`\\ 範例中，有使用了低階協定以及 :meth:"
 "`loop.create_connection` 方法。"
 
-#: ../../library/asyncio-stream.rst:605
+#: ../../library/asyncio-stream.rst:615
 msgid ""
 "The :ref:`watch a file descriptor for read events "
 "<asyncio_example_watch_fd>` example uses the low-level :meth:`loop."