Sync with CPython 3.12 (#927)

Author: pydoc-zh-tw[bot]

.scripts/poetry.lock

@@ -178,7 +178,7 @@ the PSF for inclusion in the documentation.
 
        cd ../cpython/Doc/build/html
        python3 -m http.server
-   
+
    你也可以執行下列指令請瀏覽器打開編譯出來的文件\
    以確認整份文件的語意通暢（翻譯別的檔案時將 library/math 換成別的檔名）：
 

README.rst

@@ -36,7 +36,7 @@ msgid ""
 "like to know of any deficiencies you find in Python."
 msgstr ""
 "Python 已經是一個以穩定著稱的成熟程式語言。為了維持「穩定」的信譽，開發者們想"
-"知道任何您在 Python 中發現的缺失。"
+"知道任何你在 Python 中發現的缺失。"
 
 #: ../../bugs.rst:11
 msgid ""
@@ -58,8 +58,8 @@ msgid ""
 "improvement, please submit a bug report on the :ref:`tracker <using-the-"
 "tracker>`.  If you have a suggestion on how to fix it, include that as well."
 msgstr ""
-"如果您在這份說明文件中發現了錯誤並想要幫助我們改進，請將錯誤報告提交到\\ :"
-"ref:`追蹤系統 (tracker) <using-the-tracker>`。如果您有相應的修正建議，請一併"
+"如果你在這份說明文件中發現了錯誤並想要幫助我們改進，請將錯誤報告提交到\\ :"
+"ref:`追蹤系統 (tracker) <using-the-tracker>`。如果你有相應的修正建議，請一併"
 "提交。（譯者註：如果是繁體中文說明文件翻譯相關的錯誤，請提交到 https://"
 "github.com/python/python-docs-zh-tw/issues。）"
 
@@ -85,9 +85,9 @@ msgid ""
 "'docs@' is a mailing list run by volunteers; your request will be noticed, "
 "though it may take a while to be processed."
 msgstr ""
-"如果您的時間有限，也可以將說明文件的錯誤報告以電子郵件寄到 docs@python.org\\ "
+"如果你的時間有限，也可以將說明文件的錯誤報告以電子郵件寄到 docs@python.org\\ "
 "（程式碼執行的錯誤可以寄到 python-list@python.org）。「docs@」是一個由志工們"
-"所運行的郵寄清單；您的請求會被注意到，但可能需要一些時間才會被處理。"
+"所運行的郵寄清單；你的請求會被注意到，但可能需要一些時間才會被處理。"
 
 #: ../../bugs.rst:36
 msgid "`Documentation bugs`_"
@@ -163,9 +163,9 @@ msgid ""
 "page."
 msgstr ""
 "填寫報告的第一步，是確認該問題是否已經被回報過了。這樣做的好處，除了可以節省"
-"開發者的時間，也能讓您了解目前關於該問題的處理進度；有可能已經在下一個發行版"
+"開發者的時間，也能讓你了解目前關於該問題的處理進度；有可能已經在下一個發行版"
 "本中修正了這個問題，也有可能需要更詳細的資訊（在這種情況下，如果可以，非常歡"
-"迎您提供資訊！）。要確認是否重複回報，請使用頁面頂端的搜尋框來搜尋追蹤系統。"
+"迎你提供資訊！）。要確認是否重複回報，請使用頁面頂端的搜尋框來搜尋追蹤系統。"
 
 #: ../../bugs.rst:66
 msgid ""
@@ -174,15 +174,15 @@ msgid ""
 "using the \"Sign up\" link. It is not possible to submit a bug report "
 "anonymously."
 msgstr ""
-"如果您想回報的問題還沒有在問題列表出現過，請登入 GitHub。如果您還沒有 GitHub "
-"帳戶，請點選「Sign up」連結來建立一個新的帳戶。您無法以匿名方式提交錯誤報告。"
+"如果你想回報的問題還沒有在問題列表出現過，請登入 GitHub。如果你還沒有 GitHub "
+"帳戶，請點選「Sign up」連結來建立一個新的帳戶。你無法以匿名方式提交錯誤報告。"
 
 #: ../../bugs.rst:71
 msgid ""
 "Being now logged in, you can submit an issue. Click on the \"New issue\" "
 "button in the top bar to report a new issue."
 msgstr ""
-"如果已經登入，那您就可以提交問題了。請點選列表頂端區域的「New issue」按鈕，來"
+"如果已經登入，那你就可以提交問題了。請點選列表頂端區域的「New issue」按鈕，來"
 "回報一個新的問題。"
 
 #: ../../bugs.rst:74
@@ -203,8 +203,8 @@ msgid ""
 "extension modules were involved, and what hardware and software platform you "
 "were using (including version information as appropriate)."
 msgstr ""
-"在「Comment」欄位，請詳細描述該問題，包括您預期發生的情況和實際發生的情況。請"
-"確定說明中包含了涉及到的任何擴充模組，以及您當時所使用的硬體和軟體平台（視情"
+"在「Comment」欄位，請詳細描述該問題，包括你預期發生的情況和實際發生的情況。請"
+"確定說明中包含了涉及到的任何擴充模組，以及你當時所使用的硬體和軟體平台（視情"
 "況而定，可以附上版本資訊）。"
 
 #: ../../bugs.rst:84
@@ -214,7 +214,7 @@ msgid ""
 "time an action is taken on the issue."
 msgstr ""
 "每一份問題報告都會被一位開發人員查核，並由他決定要做出什麼變更來修正這個問"
-"題。每當該問題有修正動作時，您會收到更新回報。"
+"題。每當該問題有修正動作時，你會收到更新回報。"
 
 #: ../../bugs.rst:91
 msgid ""
@@ -259,7 +259,7 @@ msgid ""
 "the `core-mentorship mailing list`_ is a friendly place to get answers to "
 "any and all questions pertaining to the process of fixing issues in Python."
 msgstr ""
-"除了只是回報您所發現的錯誤之外，同樣也歡迎您提交修正它們的修補程式 (patch)。"
-"您可以在 `Python 開發者指南`_\\ 中找到如何開始修補 Python 的更多資訊。如果您"
-"有任何問題，`核心導師郵寄清單`_\\ 是一個友善的地方，您可以在那裡得到，關於 "
+"除了只是回報你所發現的錯誤之外，同樣也歡迎你提交修正它們的修補程式 (patch)。"
+"你可以在 `Python 開發者指南`_\\ 中找到如何開始修補 Python 的更多資訊。如果你"
+"有任何問題，`核心導師郵寄清單`_\\ 是一個友善的地方，你可以在那裡得到，關於 "
 "Python 修正錯誤的過程中，所有問題的答案。"

bugs.po

@@ -7,7 +7,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.12\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-04-18 00:04+0000\n"
+"POT-Creation-Date: 2024-07-20 00:03+0000\n"
 "PO-Revision-Date: 2022-10-16 03:21+0800\n"
 "Last-Translator: Adrian Liaw <adrianliaw2000@gmail.com>\n"
 "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -552,15 +552,15 @@ msgid "``f`` (:class:`float`) [float]"
 msgstr "``f`` (:class:`float`) [float]"
 
 #: ../../c-api/arg.rst:283
-msgid "Convert a Python floating point number to a C :c:expr:`float`."
+msgid "Convert a Python floating-point number to a C :c:expr:`float`."
 msgstr "將一個 Python 浮點數轉換成 C 的 :c:type::c:expr:`float`。"
 
 #: ../../c-api/arg.rst:285 ../../c-api/arg.rst:609
 msgid "``d`` (:class:`float`) [double]"
 msgstr "``d`` (:class:`float`) [double]"
 
 #: ../../c-api/arg.rst:286
-msgid "Convert a Python floating point number to a C :c:expr:`double`."
+msgid "Convert a Python floating-point number to a C :c:expr:`double`."
 msgstr "將一個 Python 浮點數轉換成 C 的 :c:type::c:expr:`double`。"
 
 #: ../../c-api/arg.rst:288
@@ -1039,11 +1039,11 @@ msgstr ""
 "`str`。"
 
 #: ../../c-api/arg.rst:610
-msgid "Convert a C :c:expr:`double` to a Python floating point number."
+msgid "Convert a C :c:expr:`double` to a Python floating-point number."
 msgstr "將一個 C 的 :c:expr:`double` 轉換成 Python 浮點數。"
 
 #: ../../c-api/arg.rst:613
-msgid "Convert a C :c:expr:`float` to a Python floating point number."
+msgid "Convert a C :c:expr:`float` to a Python floating-point number."
 msgstr "將一個 C 的 :c:expr:`float` 轉換成 Python 浮點數。"
 
 #: ../../c-api/arg.rst:615

c-api/arg.po

@@ -7,7 +7,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.12\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2023-05-09 00:15+0000\n"
+"POT-Creation-Date: 2024-08-04 00:03+0000\n"
 "PO-Revision-Date: 2023-08-12 11:42+0800\n"
 "Last-Translator: Liang-Bo Wang <me@liang2.tw>\n"
 "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -68,48 +68,49 @@ msgstr ""
 "由任意物件 *o* 回傳一個新的位元組陣列物件，並實作了\\ :ref:`緩衝協議 (buffer "
 "protocol) <bufferobjects>`。"
 
-#: ../../c-api/bytearray.rst:48
-msgid ""
-"Create a new bytearray object from *string* and its length, *len*.  On "
-"failure, ``NULL`` is returned."
-msgstr ""
-"從 *string* 及其長度 *len* 建立一個新的位元組陣列物件。若失敗則回傳 "
-"``NULL``。"
+#: ../../c-api/bytearray.rst:45 ../../c-api/bytearray.rst:52
+#: ../../c-api/bytearray.rst:59
+msgid "On failure, return ``NULL`` with an exception set."
+msgstr "在失敗時，會回傳 ``NULL`` 並設定例外。"
 
-#: ../../c-api/bytearray.rst:54
+#: ../../c-api/bytearray.rst:50
+msgid "Create a new bytearray object from *string* and its length, *len*."
+msgstr "從 *string* 及其長度 *len* 建立一個新的位元組陣列物件。"
+
+#: ../../c-api/bytearray.rst:57
 msgid ""
 "Concat bytearrays *a* and *b* and return a new bytearray with the result."
 msgstr "連接位元組陣列 *a* 和 *b*，並回傳一個包含結果的新位元組陣列。"
 
-#: ../../c-api/bytearray.rst:59
+#: ../../c-api/bytearray.rst:64
 msgid "Return the size of *bytearray* after checking for a ``NULL`` pointer."
 msgstr "在檢查為 ``NULL`` 指標後，回傳 *bytearray* 的大小。"
 
-#: ../../c-api/bytearray.rst:64
+#: ../../c-api/bytearray.rst:69
 msgid ""
 "Return the contents of *bytearray* as a char array after checking for a "
 "``NULL`` pointer.  The returned array always has an extra null byte appended."
 msgstr ""
 "在檢查是否為 ``NULL`` 指標後，將 *bytearray* 的內容回傳為字元陣列。回傳的陣列"
 "總是會多附加一個空位元組。"
 
-#: ../../c-api/bytearray.rst:71
+#: ../../c-api/bytearray.rst:76
 msgid "Resize the internal buffer of *bytearray* to *len*."
 msgstr "將 *bytearray* 的內部緩衝區大小調整為 *len*。"
 
-#: ../../c-api/bytearray.rst:74
+#: ../../c-api/bytearray.rst:79
 msgid "Macros"
 msgstr "巨集"
 
-#: ../../c-api/bytearray.rst:76
+#: ../../c-api/bytearray.rst:81
 msgid "These macros trade safety for speed and they don't check pointers."
 msgstr "這些巨集犧牲了安全性以換取速度，並且它們不會檢查指標。"
 
-#: ../../c-api/bytearray.rst:80
+#: ../../c-api/bytearray.rst:85
 msgid "Similar to :c:func:`PyByteArray_AsString`, but without error checking."
 msgstr "與 :c:func:`PyByteArray_AsString` 類似，但沒有錯誤檢查。"
 
-#: ../../c-api/bytearray.rst:85
+#: ../../c-api/bytearray.rst:90
 msgid "Similar to :c:func:`PyByteArray_Size`, but without error checking."
 msgstr "與 :c:func:`PyByteArray_Size` 類似，但沒有錯誤檢查。"
 

c-api/bytearray.po

@@ -9,7 +9,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.12\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-02-12 00:03+0000\n"
+"POT-Creation-Date: 2024-08-04 00:03+0000\n"
 "PO-Revision-Date: 2023-04-24 20:38+0800\n"
 "Last-Translator: Matt Wang <mattwang44@gmail.com>\n"
 "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"

c-api/file.po

@@ -9,7 +9,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.12\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2023-07-22 00:04+0000\n"
+"POT-Creation-Date: 2024-07-20 00:03+0000\n"
 "PO-Revision-Date: 2017-09-22 18:26+0000\n"
 "Last-Translator: Liang-Bo Wang <me@liang2.tw>\n"
 "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -21,17 +21,17 @@ msgstr ""
 "Plural-Forms: nplurals=1; plural=0;\n"
 
 #: ../../c-api/float.rst:6
-msgid "Floating Point Objects"
-msgstr "浮點數（Floating Point）物件"
+msgid "Floating-Point Objects"
+msgstr "浮點數（Floating-Point）物件"
 
 #: ../../c-api/float.rst:13
 msgid ""
-"This subtype of :c:type:`PyObject` represents a Python floating point object."
+"This subtype of :c:type:`PyObject` represents a Python floating-point object."
 msgstr ""
 
 #: ../../c-api/float.rst:18
 msgid ""
-"This instance of :c:type:`PyTypeObject` represents the Python floating point "
+"This instance of :c:type:`PyTypeObject` represents the Python floating-point "
 "type.  This is the same object as :class:`float` in the Python layer."
 msgstr ""
 
@@ -61,7 +61,7 @@ msgstr ""
 #: ../../c-api/float.rst:47
 msgid ""
 "Return a C :c:expr:`double` representation of the contents of *pyfloat*.  If "
-"*pyfloat* is not a Python floating point object but has a :meth:`~object."
+"*pyfloat* is not a Python floating-point object but has a :meth:`~object."
 "__float__` method, this method will first be called to convert *pyfloat* "
 "into a float. If :meth:`!__float__` is not defined then it falls back to :"
 "meth:`~object.__index__`. This method returns ``-1.0`` upon failure, so one "
@@ -217,5 +217,5 @@ msgid "object"
 msgstr "object（物件）"
 
 #: ../../c-api/float.rst:8
-msgid "floating point"
-msgstr "floating point（浮點）"
+msgid "floating-point"
+msgstr "floating-point（浮點）"

c-api/float.po

@@ -8,7 +8,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.12\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-06-22 00:03+0000\n"
+"POT-Creation-Date: 2024-08-04 00:03+0000\n"
 "PO-Revision-Date: 2023-04-24 20:49+0800\n"
 "Last-Translator: Adrian Liaw <adrianliaw2000@gmail.com>\n"
 "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -2493,7 +2493,7 @@ msgstr ""
 
 #: ../../c-api/init.rst:2177
 msgid "Thread Local Storage (TLS) API"
-msgstr ""
+msgstr "執行緒局部儲存 (Thread Local Storage, TLS) API："
 
 #: ../../c-api/init.rst:2179
 msgid ""

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: 2023-08-23 00:03+0000\n"
+"POT-Creation-Date: 2024-07-23 00:04+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-"
@@ -595,7 +595,7 @@ msgstr ""
 msgid ""
 "The :c:func:`PyConfig_Read` function only parses :c:member:`PyConfig.argv` "
 "arguments once: :c:member:`PyConfig.parse_argv` is set to ``2`` after "
-"arguments are parsed. Since Python arguments are strippped from :c:member:"
+"arguments are parsed. Since Python arguments are stripped from :c:member:"
 "`PyConfig.argv`, parsing arguments twice would parse the application options "
 "as Python options."
 msgstr ""