sync with cpython 758278c2

Author: github-actions[bot]

c-api/marshal.po

@@ -8,7 +8,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.14\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2025-11-05 00:16+0000\n"
+"POT-Creation-Date: 2026-10-12 00:24+0000\n"
 "PO-Revision-Date: 2025-06-28 02:44+0800\n"
 "Last-Translator: Matt Wang <mattwang44@gmail.com>\n"
 "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -60,7 +60,7 @@ msgstr ""
 "低有效 32 位元；無論原生 :c:expr:`long` 型別的大小如何。*version* 表示檔案的"
 "格式。"
 
-#: ../../c-api/marshal.rst:29 ../../c-api/marshal.rst:37
+#: ../../c-api/marshal.rst:29 ../../c-api/marshal.rst:43
 msgid ""
 "This function can fail, in which case it sets the error indicator. Use :c:"
 "func:`PyErr_Occurred` to check for that."
@@ -70,23 +70,41 @@ msgstr ""
 
 #: ../../c-api/marshal.rst:34
 msgid ""
+"In Python 3.15 and earlier, this function does not set the error indicator "
+"if writing to *file* fails. The same caveat applies as for :c:func:"
+"`PyMarshal_WriteObjectToFile`."
+msgstr ""
+
+#: ../../c-api/marshal.rst:40
+msgid ""
 "Marshal a Python object, *value*, to *file*. *version* indicates the file "
 "format."
 msgstr ""
 "將一個 Python 物件 *value* marshal 為 *file*。*version* 表示檔案的格式。"
 
-#: ../../c-api/marshal.rst:42
+#: ../../c-api/marshal.rst:48
+msgid ""
+"In Python 3.15 and earlier, this function can write only part of the data to "
+"*file* and return without setting the error indicator, for example if "
+"*value* contains an object which cannot be marshalled or if writing to "
+"*file* fails (see :gh:`155907`). Code which has to support these versions "
+"cannot rely on :c:func:`PyErr_Occurred` alone to know that all the data was "
+"written. It can use :c:func:`PyMarshal_WriteObjectToString` and write the "
+"result itself, or validate what was written."
+msgstr ""
+
+#: ../../c-api/marshal.rst:59
 msgid ""
 "Return a bytes object containing the marshalled representation of *value*. "
 "*version* indicates the file format."
 msgstr ""
 "回傳一個位元組物件，包含 *value* 的 marshal 表示。*version* 為檔案的格式。"
 
-#: ../../c-api/marshal.rst:46
+#: ../../c-api/marshal.rst:63
 msgid "The following functions allow marshalled values to be read back in."
 msgstr "以下函式允許將 marshal 過後的值讀取回來。"
 
-#: ../../c-api/marshal.rst:51
+#: ../../c-api/marshal.rst:68
 msgid ""
 "Return a C :c:expr:`long` from the data stream in a :c:expr:`FILE*` opened "
 "for reading.  Only a 32-bit value can be read in using this function, "
@@ -95,13 +113,13 @@ msgstr ""
 "從一個為讀取而開啟的 :c:expr:`FILE*` 中的資料串流回傳一個 C :c:expr:`long`。"
 "無論 :c:expr:`long` 的原生大小如何，這個函式只能讀取 32 位元的值。"
 
-#: ../../c-api/marshal.rst:55 ../../c-api/marshal.rst:65
+#: ../../c-api/marshal.rst:72 ../../c-api/marshal.rst:82
 msgid ""
 "On error, sets the appropriate exception (:exc:`EOFError`) and returns "
 "``-1``."
 msgstr "在錯誤發生時，會設定合適的例外（:exc:`EOFError`）並回傳 ``-1``。"
 
-#: ../../c-api/marshal.rst:61
+#: ../../c-api/marshal.rst:78
 msgid ""
 "Return a C :c:expr:`short` from the data stream in a :c:expr:`FILE*` opened "
 "for reading.  Only a 16-bit value can be read in using this function, "
@@ -110,23 +128,23 @@ msgstr ""
 "從一個為讀取而開啟的 :c:expr:`FILE*` 中的資料串流回傳一個 C :c:expr:`short`。"
 "無論 :c:expr:`short` 的原生大小如何，這個函式只能讀取 16 位元的值。"
 
-#: ../../c-api/marshal.rst:71
+#: ../../c-api/marshal.rst:88
 msgid ""
 "Return a Python object from the data stream in a :c:expr:`FILE*` opened for "
 "reading."
 msgstr ""
 "從一個為讀取而開啟的 :c:expr:`FILE*` 中的資料串流回傳一個 Python 物件。"
 
-#: ../../c-api/marshal.rst:74 ../../c-api/marshal.rst:88
-#: ../../c-api/marshal.rst:97
+#: ../../c-api/marshal.rst:91 ../../c-api/marshal.rst:105
+#: ../../c-api/marshal.rst:114
 msgid ""
 "On error, sets the appropriate exception (:exc:`EOFError`, :exc:`ValueError` "
 "or :exc:`TypeError`) and returns ``NULL``."
 msgstr ""
 "在錯誤發生時，會設定合適的例外（:exc:`EOFError`、:exc:`ValueError` 或 :exc:"
 "`TypeError`）並回傳 ``NULL``。"
 
-#: ../../c-api/marshal.rst:80
+#: ../../c-api/marshal.rst:97
 msgid ""
 "Return a Python object from the data stream in a :c:expr:`FILE*` opened for "
 "reading.  Unlike :c:func:`PyMarshal_ReadObjectFromFile`, this function "
@@ -142,7 +160,7 @@ msgstr ""
 "而不是從檔案中逐位元組讀取。只有在確定不會從檔案中讀取其他內容時，才使用這個"
 "變體。"
 
-#: ../../c-api/marshal.rst:94
+#: ../../c-api/marshal.rst:111
 msgid ""
 "Return a Python object from the data stream in a byte buffer containing "
 "*len* bytes pointed to by *data*."

library/idle.po

@@ -6,7 +6,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.14\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2026-01-21 00:15+0000\n"
+"POT-Creation-Date: 2026-10-12 00:24+0000\n"
 "PO-Revision-Date: 2018-05-23 16:03+0000\n"
 "Last-Translator: Adrian Liaw <adrianliaw2000@gmail.com>\n"
 "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -1554,19 +1554,19 @@ msgid ""
 "mainloop call when running in standard Python."
 msgstr ""
 
-#: ../../library/idle.rst:937
+#: ../../library/idle.rst:939
 msgid "Running without a subprocess"
 msgstr ""
 
-#: ../../library/idle.rst:939
+#: ../../library/idle.rst:941
 msgid ""
 "By default, IDLE executes user code in a separate subprocess via a socket, "
 "which uses the internal loopback interface.  This connection is not "
 "externally visible and no data is sent to or received from the internet. If "
 "firewall software complains anyway, you can ignore it."
 msgstr ""
 
-#: ../../library/idle.rst:944
+#: ../../library/idle.rst:946
 msgid ""
 "If the attempt to make the socket connection fails, Idle will notify you. "
 "Such failures are sometimes transient, but if persistent, the problem may be "
@@ -1575,7 +1575,7 @@ msgid ""
 "command line switch."
 msgstr ""
 
-#: ../../library/idle.rst:950
+#: ../../library/idle.rst:952
 msgid ""
 "If IDLE is started with the -n command line switch it will run in a single "
 "process and will not create the subprocess which runs the RPC Python "
@@ -1589,15 +1589,15 @@ msgid ""
 "at all possible."
 msgstr ""
 
-#: ../../library/idle.rst:965
+#: ../../library/idle.rst:967
 msgid "Help and Preferences"
 msgstr ""
 
-#: ../../library/idle.rst:970
+#: ../../library/idle.rst:972
 msgid "Help sources"
 msgstr ""
 
-#: ../../library/idle.rst:972
+#: ../../library/idle.rst:974
 msgid ""
 "Help menu entry \"IDLE Help\" displays a formatted html version of the IDLE "
 "chapter of the Library Reference.  The result, in a read-only tkinter text "
@@ -1607,7 +1607,7 @@ msgid ""
 "the opened box."
 msgstr ""
 
-#: ../../library/idle.rst:980
+#: ../../library/idle.rst:982
 msgid ""
 "Help menu entry \"Python Docs\" opens the extensive sources of help, "
 "including tutorials, available at ``docs.python.org/x.y``, where 'x.y' is "
@@ -1616,17 +1616,17 @@ msgid ""
 "instead."
 msgstr ""
 
-#: ../../library/idle.rst:986
+#: ../../library/idle.rst:988
 msgid ""
 "Selected URLs can be added or removed from the help menu at any time using "
 "the General tab of the Configure IDLE dialog."
 msgstr ""
 
-#: ../../library/idle.rst:992
+#: ../../library/idle.rst:994
 msgid "Setting preferences"
 msgstr "設定偏好"
 
-#: ../../library/idle.rst:994
+#: ../../library/idle.rst:996
 msgid ""
 "The font preferences, highlighting, keys, and general preferences can be "
 "changed via Configure IDLE on the Option menu. Non-default user settings are "
@@ -1635,7 +1635,7 @@ msgid ""
 "or more of the files in ``.idlerc``."
 msgstr ""
 
-#: ../../library/idle.rst:1000
+#: ../../library/idle.rst:1002
 msgid ""
 "On the Font tab, see the text sample for the effect of font face and size on "
 "multiple characters in multiple languages.  Edit the sample to add other "
@@ -1644,30 +1644,30 @@ msgid ""
 "them to the top of the sample and try changing first size and then font."
 msgstr ""
 
-#: ../../library/idle.rst:1007
+#: ../../library/idle.rst:1009
 msgid ""
 "On the Highlights and Keys tab, select a built-in or custom color theme and "
 "key set.  To use a newer built-in color theme or key set with older IDLEs, "
 "save it as a new custom theme or key set and it well be accessible to older "
 "IDLEs."
 msgstr ""
 
-#: ../../library/idle.rst:1013
+#: ../../library/idle.rst:1015
 msgid "IDLE on macOS"
 msgstr "macOS 上的 IDLE"
 
-#: ../../library/idle.rst:1015
+#: ../../library/idle.rst:1017
 msgid ""
 "Under System Preferences: Dock, one can set \"Prefer tabs when opening "
 "documents\" to \"Always\".  This setting is not compatible with the tk/"
 "tkinter GUI framework used by IDLE, and it breaks a few IDLE features."
 msgstr ""
 
-#: ../../library/idle.rst:1020
+#: ../../library/idle.rst:1022
 msgid "Extensions"
 msgstr ""
 
-#: ../../library/idle.rst:1022
+#: ../../library/idle.rst:1024
 msgid ""
 "IDLE contains an extension facility.  Preferences for extensions can be "
 "changed with the Extensions tab of the preferences dialog. See the beginning "
@@ -1676,21 +1676,21 @@ msgid ""
 "testing."
 msgstr ""
 
-#: ../../library/idle.rst:1030
+#: ../../library/idle.rst:1032
 msgid "idlelib --- implementation of IDLE application"
 msgstr ""
 
-#: ../../library/idle.rst:1035
+#: ../../library/idle.rst:1037
 msgid "**Source code:** :source:`Lib/idlelib`"
 msgstr "**原始碼：**\\ :source:`Lib/idlelib/`"
 
-#: ../../library/idle.rst:1039
+#: ../../library/idle.rst:1041
 msgid ""
 "The Lib/idlelib package implements the IDLE application.  See the rest of "
 "this page for how to use IDLE."
 msgstr ""
 
-#: ../../library/idle.rst:1042
+#: ../../library/idle.rst:1044
 msgid ""
 "The files in idlelib are described in idlelib/README.txt.  Access it either "
 "in idlelib or click Help => About IDLE on the IDLE menu.  This file also "