sync with cpython 556fb367

Author: github-actions[bot]

c-api/init.po

@@ -8,7 +8,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.12\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-03-07 17:26+0000\n"
+"POT-Creation-Date: 2024-04-16 00:03+0000\n"
 "PO-Revision-Date: 2023-04-24 20:49+0800\n"
 "Last-Translator: Adrian Liaw <[email protected]>\n"
 "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -949,8 +949,7 @@ msgstr ""
 msgid ""
 "It is recommended that applications embedding the Python interpreter for "
 "purposes other than executing a single script pass ``0`` as *updatepath*, "
-"and update :data:`sys.path` themselves if desired. See `CVE-2008-5983 "
-"<https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2008-5983>`_."
+"and update :data:`sys.path` themselves if desired. See :cve:`2008-5983`."
 msgstr ""
 
 #: ../../c-api/init.rst:765

faq/library.po

@@ -9,7 +9,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.12\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2023-08-21 00:03+0000\n"
+"POT-Creation-Date: 2024-04-16 00:03+0000\n"
 "PO-Revision-Date: 2023-02-18 13:22+0800\n"
 "Last-Translator: Adrian Liaw <[email protected]>\n"
 "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -821,40 +821,40 @@ msgstr ""
 "型別相同。因此，要從使用 :func:`os.popen` 建立的管道 *p* 中讀取 *n* 個位元"
 "組，你需要使用 ``p.read(n)``。"
 
-#: ../../faq/library.rst:618
+#: ../../faq/library.rst:617
 msgid "How do I access the serial (RS232) port?"
 msgstr "如何存取序列 (RS232) 連接埠？"
 
-#: ../../faq/library.rst:620
+#: ../../faq/library.rst:619
 msgid "For Win32, OSX, Linux, BSD, Jython, IronPython:"
 msgstr "對於 Win32、OSX、Linux、BSD、Jython、IronPython："
 
-#: ../../faq/library.rst:622
-msgid "https://pypi.org/project/pyserial/"
-msgstr "https://pypi.org/project/pyserial/"
+#: ../../faq/library.rst:621
+msgid ":pypi:`pyserial`"
+msgstr ""
 
-#: ../../faq/library.rst:624
+#: ../../faq/library.rst:623
 msgid "For Unix, see a Usenet post by Mitch Chapman:"
 msgstr "對於 Unix，請參閱 Mitch Chapman 的 Usenet 貼文："
 
-#: ../../faq/library.rst:626
+#: ../../faq/library.rst:625
 msgid "https://groups.google.com/[email protected]"
 msgstr "https://groups.google.com/[email protected]"
 
-#: ../../faq/library.rst:630
+#: ../../faq/library.rst:629
 #, fuzzy
 msgid "Why doesn't closing sys.stdout (stdin, stderr) really close it?"
 msgstr "為什麼關閉 sys.stdout (stdin, stderr) 並沒有真正關閉它？"
 
-#: ../../faq/library.rst:632
+#: ../../faq/library.rst:631
 #, fuzzy
 msgid ""
 "Python :term:`file objects <file object>` are a high-level layer of "
 "abstraction on low-level C file descriptors."
 msgstr ""
 "Python :term:`file objects <file object>` 是低階 C 檔案描述器的高階抽象層。"
 
-#: ../../faq/library.rst:635
+#: ../../faq/library.rst:634
 #, fuzzy
 msgid ""
 "For most file objects you create in Python via the built-in :func:`open` "
@@ -867,7 +867,7 @@ msgstr ""
 "close()`` 從 Python 的角度將 Python 檔案物件標記為已關閉，並安排關閉底層 C 檔"
 "案描述器。當 ``f`` 變成垃圾時，這也會自動發生在 ``f`` 的析構函式中。"
 
-#: ../../faq/library.rst:641
+#: ../../faq/library.rst:640
 #, fuzzy
 msgid ""
 "But stdin, stdout and stderr are treated specially by Python, because of the "
@@ -879,7 +879,7 @@ msgstr ""
 "態。運行 ``sys.stdout.close()`` 將 Python 級檔案物件標記為已關閉，但是 * "
 "not* 關閉關聯的 C 檔案描述器。"
 
-#: ../../faq/library.rst:646
+#: ../../faq/library.rst:645
 #, fuzzy
 msgid ""
 "To close the underlying C file descriptor for one of these three, you should "
@@ -891,20 +891,20 @@ msgstr ""
 "\n"
 "::"
 
-#: ../../faq/library.rst:654
+#: ../../faq/library.rst:653
 #, fuzzy
 msgid "Or you can use the numeric constants 0, 1 and 2, respectively."
 msgstr "或者你可以分別使用數字常數 0、1 和 2。"
 
-#: ../../faq/library.rst:658
+#: ../../faq/library.rst:657
 msgid "Network/Internet Programming"
 msgstr "網路 (Network)/網際網路 (Internet) 程式"
 
-#: ../../faq/library.rst:661
+#: ../../faq/library.rst:660
 msgid "What WWW tools are there for Python?"
 msgstr "Python 有哪些 WWW 工具？"
 
-#: ../../faq/library.rst:663
+#: ../../faq/library.rst:662
 #, fuzzy
 msgid ""
 "See the chapters titled :ref:`internet` and :ref:`netdata` in the Library "
@@ -914,7 +914,7 @@ msgstr ""
 "請參閱函式庫參考手冊中標題為 :ref:`internet` 和 :ref:`netdata` 的章節。 "
 "Python 有許多模組可以幫助你構建服務器端和客戶端 Web 系統。"
 
-#: ../../faq/library.rst:669
+#: ../../faq/library.rst:668
 #, fuzzy
 msgid ""
 "A summary of available frameworks is maintained by Paul Boddie at https://"
@@ -923,7 +923,7 @@ msgstr ""
 "可用框架的摘要由 Paul Boddie 在 https://wiki.python.org/moin/"
 "WebProgramming\\ 維護。"
 
-#: ../../faq/library.rst:672
+#: ../../faq/library.rst:671
 #, fuzzy
 msgid ""
 "Cameron Laird maintains a useful set of pages about Python web technologies "
@@ -934,26 +934,26 @@ msgstr ""
 "net/claird/comp.lang.python/web_python 維護著一組有用的關於 Python 網路技術的"
 "頁面。"
 
-#: ../../faq/library.rst:677
+#: ../../faq/library.rst:676
 msgid "How can I mimic CGI form submission (METHOD=POST)?"
 msgstr "如何模擬 CGI 表單送出 (submission) (METHOD=POST)？"
 
-#: ../../faq/library.rst:679
+#: ../../faq/library.rst:678
 #, fuzzy
 msgid ""
 "I would like to retrieve web pages that are the result of POSTing a form. Is "
 "there existing code that would let me do this easily?"
 msgstr ""
 "我想檢索作為發布表單結果的網頁。是否有現成的程式碼可以讓我輕鬆地做到這一點？"
 
-#: ../../faq/library.rst:682
+#: ../../faq/library.rst:681
 msgid "Yes. Here's a simple example that uses :mod:`urllib.request`::"
 msgstr ""
 "是的，這是一個 :mod:`urllib.request` 的簡單範例：\n"
 "\n"
 "::"
 
-#: ../../faq/library.rst:697
+#: ../../faq/library.rst:696
 #, fuzzy
 msgid ""
 "Note that in general for percent-encoded POST operations, query strings must "
@@ -965,15 +965,15 @@ msgstr ""
 "\n"
 "::"
 
-#: ../../faq/library.rst:705
+#: ../../faq/library.rst:704
 msgid ":ref:`urllib-howto` for extensive examples."
 msgstr ":ref:`urllib-howto` 內有大量範例。"
 
-#: ../../faq/library.rst:709
+#: ../../faq/library.rst:708
 msgid "What module should I use to help with generating HTML?"
 msgstr "我應該使用什麼模組來輔助產生 HTML？"
 
-#: ../../faq/library.rst:713
+#: ../../faq/library.rst:712
 #, fuzzy
 msgid ""
 "You can find a collection of useful links on the `Web Programming wiki page "
@@ -982,15 +982,15 @@ msgstr ""
 "你可以在 \"Web 編寫程式維基頁面 <https://wiki.python.org/moin/"
 "WebProgramming>\" 上找到一組有用的鏈接。"
 
-#: ../../faq/library.rst:718
+#: ../../faq/library.rst:717
 msgid "How do I send mail from a Python script?"
 msgstr "如何從 Python 腳本發送郵件？"
 
-#: ../../faq/library.rst:720
+#: ../../faq/library.rst:719
 msgid "Use the standard library module :mod:`smtplib`."
 msgstr "使用標準函式庫模組 :mod:`smtplib`。"
 
-#: ../../faq/library.rst:722
+#: ../../faq/library.rst:721
 #, fuzzy
 msgid ""
 "Here's a very simple interactive mail sender that uses it.  This method will "
@@ -1001,7 +1001,7 @@ msgstr ""
 "\n"
 "::"
 
-#: ../../faq/library.rst:742
+#: ../../faq/library.rst:741
 #, fuzzy
 msgid ""
 "A Unix-only alternative uses sendmail.  The location of the sendmail program "
@@ -1015,19 +1015,19 @@ msgstr ""
 "\n"
 "::"
 
-#: ../../faq/library.rst:762
+#: ../../faq/library.rst:761
 #, fuzzy
 msgid "How do I avoid blocking in the connect() method of a socket?"
 msgstr "如何避免阻塞 socket 的 connect() 方法？"
 
-#: ../../faq/library.rst:764
+#: ../../faq/library.rst:763
 #, fuzzy
 msgid ""
 "The :mod:`select` module is commonly used to help with asynchronous I/O on "
 "sockets."
 msgstr ":mod:`select` 模組通常用於幫助處理 socket 上的非同步 I/O。"
 
-#: ../../faq/library.rst:767
+#: ../../faq/library.rst:766
 #, fuzzy
 msgid ""
 "To prevent the TCP connect from blocking, you can set the socket to non-"
@@ -1043,7 +1043,7 @@ msgstr ""
 "誤號 ``.errno``。 ``errno.EINPROGRESS`` 表示連接正在進行中，但尚未完成。不同"
 "的作業系統將回傳不同的值，因此你將不得不檢查系統回傳的內容。"
 
-#: ../../faq/library.rst:775
+#: ../../faq/library.rst:774
 #, fuzzy
 msgid ""
 "You can use the :meth:`~socket.socket.connect_ex` method to avoid creating "
@@ -1057,7 +1057,7 @@ msgstr ""
 "EISCONN`` 表示你已連接 - 或者你可以將此 socket 傳遞給：meth：` select."
 "select` 檢查它是否可寫。"
 
-#: ../../faq/library.rst:783
+#: ../../faq/library.rst:782
 msgid ""
 "The :mod:`asyncio` module provides a general purpose single-threaded and "
 "concurrent asynchronous library, which can be used for writing non-blocking "
@@ -1068,19 +1068,19 @@ msgstr ""
 "網路程式碼。第三方 `Twisted <https://twisted.org/>`_ 函式庫是一種流行且功能豐"
 "富的替代方案。"
 
-#: ../../faq/library.rst:791
+#: ../../faq/library.rst:790
 msgid "Databases"
 msgstr "資料庫"
 
-#: ../../faq/library.rst:794
+#: ../../faq/library.rst:793
 msgid "Are there any interfaces to database packages in Python?"
 msgstr "Python 中是否有任何資料庫套件的介面？"
 
-#: ../../faq/library.rst:796
+#: ../../faq/library.rst:795
 msgid "Yes."
 msgstr "有的。"
 
-#: ../../faq/library.rst:798
+#: ../../faq/library.rst:797
 #, fuzzy
 msgid ""
 "Interfaces to disk-based hashes such as :mod:`DBM <dbm.ndbm>` and :mod:`GDBM "
@@ -1092,7 +1092,7 @@ msgstr ""
 "含在標準 Python 中。還有 :mod:`sqlite3` 模組，它提供了一個輕量級的基於磁盤的"
 "關係資料庫。"
 
-#: ../../faq/library.rst:803
+#: ../../faq/library.rst:802
 #, fuzzy
 msgid ""
 "Support for most relational databases is available.  See the "
@@ -1102,12 +1102,12 @@ msgstr ""
 "支援大多數關係資料庫。有關詳細資訊，請參閱`DatabaseProgramming 維基頁面 "
 "<https://wiki.python.org/moin/DatabaseProgramming>`_。"
 
-#: ../../faq/library.rst:809
+#: ../../faq/library.rst:808
 #, fuzzy
 msgid "How do you implement persistent objects in Python?"
 msgstr "你如何在 Python 中實作持久物件？"
 
-#: ../../faq/library.rst:811
+#: ../../faq/library.rst:810
 #, fuzzy
 msgid ""
 "The :mod:`pickle` library module solves this in a very general way (though "
@@ -1119,15 +1119,15 @@ msgstr ""
 "如打開的檔案、socket 或窗口之類的東西），而 :mod:`shelve` 庫模組使用 pickle "
 "和 (g) dbm 建立包含任意 Python 物件的持久映射。"
 
-#: ../../faq/library.rst:818
+#: ../../faq/library.rst:817
 msgid "Mathematics and Numerics"
 msgstr "數學和數值"
 
-#: ../../faq/library.rst:821
+#: ../../faq/library.rst:820
 msgid "How do I generate random numbers in Python?"
 msgstr "如何在 Python 中生成隨機數？"
 
-#: ../../faq/library.rst:823
+#: ../../faq/library.rst:822
 msgid ""
 "The standard module :mod:`random` implements a random number generator.  "
 "Usage is simple::"
@@ -1136,43 +1136,46 @@ msgstr ""
 "\n"
 "::"
 
-#: ../../faq/library.rst:829
+#: ../../faq/library.rst:828
 msgid "This returns a random floating point number in the range [0, 1)."
 msgstr "這將回傳 [0, 1) 範圍內的隨機浮點數。"
 
-#: ../../faq/library.rst:831
+#: ../../faq/library.rst:830
 msgid ""
 "There are also many other specialized generators in this module, such as:"
 msgstr "該模組中還有許多其他專用生成器，例如："
 
-#: ../../faq/library.rst:833
+#: ../../faq/library.rst:832
 msgid "``randrange(a, b)`` chooses an integer in the range [a, b)."
 msgstr "``randrange(a, b)`` 會選擇 [a, b) 範圍內的一個整數。"
 
-#: ../../faq/library.rst:834
+#: ../../faq/library.rst:833
 msgid "``uniform(a, b)`` chooses a floating point number in the range [a, b)."
 msgstr "``uniform(a, b)`` 會選擇 [a, b) 範圍內的浮點數。"
 
-#: ../../faq/library.rst:835
+#: ../../faq/library.rst:834
 msgid ""
 "``normalvariate(mean, sdev)`` samples the normal (Gaussian) distribution."
 msgstr "``normalvariate(mean, sdev)`` 對常態（高斯）分佈進行採樣 (sample)。"
 
-#: ../../faq/library.rst:837
+#: ../../faq/library.rst:836
 msgid "Some higher-level functions operate on sequences directly, such as:"
 msgstr "一些更高階的函式會直接對序列進行操作，例如："
 
-#: ../../faq/library.rst:839
+#: ../../faq/library.rst:838
 msgid "``choice(S)`` chooses a random element from a given sequence."
 msgstr "``choice(S)`` 會從給定序列中選擇一個隨機元素。"
 
-#: ../../faq/library.rst:840
+#: ../../faq/library.rst:839
 msgid "``shuffle(L)`` shuffles a list in-place, i.e. permutes it randomly."
 msgstr "``shuffle(L)`` 會原地 (in-place) 打亂 list，即隨機排列它。"
 
-#: ../../faq/library.rst:842
+#: ../../faq/library.rst:841
 msgid ""
 "There's also a ``Random`` class you can instantiate to create independent "
 "multiple random number generators."
 msgstr ""
 "還有一個 ``Random`` 類別，你可以將它實例化以建立多個獨立的隨機數生成器。"
+
+#~ msgid "https://pypi.org/project/pyserial/"
+#~ msgstr "https://pypi.org/project/pyserial/"