sync with cpython 9a434858

Author: github-actions[bot]

c-api/allocation.po

@@ -9,7 +9,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.13\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-11-06 00:13+0000\n"
+"POT-Creation-Date: 2025-03-18 00:14+0000\n"
 "PO-Revision-Date: 2022-10-16 15:35+0800\n"
 "Last-Translator: Matt Wang <[email protected]>\n"
 "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -56,7 +56,14 @@ msgstr ""
 "化；呼叫者會擁有那個對於物件的唯一參照（物件的參照計數為一）。記憶體分配大小"
 "由 type 物件的 :c:member:`~PyTypeObject.tp_basicsize` 欄位來指定。"
 
-#: ../../c-api/allocation.rst:41
+#: ../../c-api/allocation.rst:38
+msgid ""
+"Note that this function is unsuitable if *typeobj* has :c:macro:"
+"`Py_TPFLAGS_HAVE_GC` set. For such objects, use :c:func:`PyObject_GC_New` "
+"instead."
+msgstr ""
+
+#: ../../c-api/allocation.rst:45
 msgid ""
 "Allocate a new Python object using the C structure type *TYPE* and the "
 "Python type object *typeobj* (``PyTypeObject*``). Fields not defined by the "
@@ -75,7 +82,14 @@ msgstr ""
 "於實現如 tuple 這種能夠在建立期間決定自己大小的物件是很實用的。將欄位的陣列嵌"
 "入到相同的記憶體分配中可以減少記憶體分配的次數，這提高了記憶體管理的效率。"
 
-#: ../../c-api/allocation.rst:55
+#: ../../c-api/allocation.rst:56
+msgid ""
+"Note that this function is unsuitable if *typeobj* has :c:macro:"
+"`Py_TPFLAGS_HAVE_GC` set. For such objects, use :c:func:`PyObject_GC_NewVar` "
+"instead."
+msgstr ""
+
+#: ../../c-api/allocation.rst:63
 msgid ""
 "Releases memory allocated to an object using :c:macro:`PyObject_New` or :c:"
 "macro:`PyObject_NewVar`.  This is normally called from the :c:member:"
@@ -88,7 +102,7 @@ msgstr ""
 "handler 中呼叫。呼叫這個函式以後，物件的各欄位都不可以被存取，因為原本分配的"
 "記憶體已不再是一個有效的 Python 物件。"
 
-#: ../../c-api/allocation.rst:64
+#: ../../c-api/allocation.rst:72
 msgid ""
 "Object which is visible in Python as ``None``.  This should only be accessed "
 "using the :c:macro:`Py_None` macro, which evaluates to a pointer to this "
@@ -97,10 +111,10 @@ msgstr ""
 "這個物件像是 Python 中的 ``None``。它只應該透過 :c:macro:`Py_None` 巨集來存"
 "取，該巨集的拿到指向該物件的指標。"
 
-#: ../../c-api/allocation.rst:71
+#: ../../c-api/allocation.rst:79
 msgid ":c:func:`PyModule_Create`"
 msgstr ":c:func:`PyModule_Create`"
 
-#: ../../c-api/allocation.rst:72
+#: ../../c-api/allocation.rst:80
 msgid "To allocate and create extension modules."
 msgstr "分配記憶體和建立擴充模組。"

c-api/type.po

@@ -6,7 +6,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.13\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-12-01 15:01+0000\n"
+"POT-Creation-Date: 2025-03-18 00:14+0000\n"
 "PO-Revision-Date: 2015-12-09 17:51+0000\n"
 "Last-Translator: Liang-Bo Wang <[email protected]>\n"
 "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -450,20 +450,22 @@ msgid ""
 "If negative, the absolute value specifies how much space instances of the "
 "class need *in addition* to the superclass. Use :c:func:"
 "`PyObject_GetTypeData` to get a pointer to subclass-specific memory reserved "
-"this way."
+"this way. For negative :c:member:`!basicsize`, Python will insert padding "
+"when needed to meet :c:member:`~PyTypeObject.tp_basicsize`'s alignment "
+"requirements."
 msgstr ""
 
-#: ../../c-api/type.rst:418
+#: ../../c-api/type.rst:421
 msgid "Previously, this field could not be negative."
 msgstr ""
 
-#: ../../c-api/type.rst:422
+#: ../../c-api/type.rst:425
 msgid ""
 "Size of one element of a variable-size type, in bytes. Used to set :c:member:"
 "`PyTypeObject.tp_itemsize`. See ``tp_itemsize`` documentation for caveats."
 msgstr ""
 
-#: ../../c-api/type.rst:426
+#: ../../c-api/type.rst:429
 msgid ""
 "If zero, :c:member:`~PyTypeObject.tp_itemsize` is inherited. Extending "
 "arbitrary variable-sized classes is dangerous, since some types use a fixed "
@@ -472,154 +474,154 @@ msgid ""
 "only possible in the following situations:"
 msgstr ""
 
-#: ../../c-api/type.rst:433
+#: ../../c-api/type.rst:436
 msgid ""
 "The base is not variable-sized (its :c:member:`~PyTypeObject.tp_itemsize`)."
 msgstr ""
 
-#: ../../c-api/type.rst:435
+#: ../../c-api/type.rst:438
 msgid ""
 "The requested :c:member:`PyType_Spec.basicsize` is positive, suggesting that "
 "the memory layout of the base class is known."
 msgstr ""
 
-#: ../../c-api/type.rst:437
+#: ../../c-api/type.rst:440
 msgid ""
 "The requested :c:member:`PyType_Spec.basicsize` is zero, suggesting that the "
 "subclass does not access the instance's memory directly."
 msgstr ""
 
-#: ../../c-api/type.rst:440
+#: ../../c-api/type.rst:443
 msgid "With the :c:macro:`Py_TPFLAGS_ITEMS_AT_END` flag."
 msgstr ""
 
-#: ../../c-api/type.rst:444
+#: ../../c-api/type.rst:447
 msgid "Type flags, used to set :c:member:`PyTypeObject.tp_flags`."
 msgstr ""
 
-#: ../../c-api/type.rst:446
+#: ../../c-api/type.rst:449
 msgid ""
 "If the ``Py_TPFLAGS_HEAPTYPE`` flag is not set, :c:func:"
 "`PyType_FromSpecWithBases` sets it automatically."
 msgstr ""
 
-#: ../../c-api/type.rst:451
+#: ../../c-api/type.rst:454
 msgid ""
 "Array of :c:type:`PyType_Slot` structures. Terminated by the special slot "
 "value ``{0, NULL}``."
 msgstr ""
 
-#: ../../c-api/type.rst:454
+#: ../../c-api/type.rst:457
 msgid "Each slot ID should be specified at most once."
 msgstr ""
 
-#: ../../c-api/type.rst:464
+#: ../../c-api/type.rst:467
 msgid ""
 "Structure defining optional functionality of a type, containing a slot ID "
 "and a value pointer."
 msgstr ""
 
-#: ../../c-api/type.rst:469
+#: ../../c-api/type.rst:472
 msgid "A slot ID."
 msgstr ""
 
-#: ../../c-api/type.rst:471
+#: ../../c-api/type.rst:474
 msgid ""
 "Slot IDs are named like the field names of the structures :c:type:"
 "`PyTypeObject`, :c:type:`PyNumberMethods`, :c:type:`PySequenceMethods`, :c:"
 "type:`PyMappingMethods` and :c:type:`PyAsyncMethods` with an added ``Py_`` "
 "prefix. For example, use:"
 msgstr ""
 
-#: ../../c-api/type.rst:477
+#: ../../c-api/type.rst:480
 msgid "``Py_tp_dealloc`` to set :c:member:`PyTypeObject.tp_dealloc`"
 msgstr ""
 
-#: ../../c-api/type.rst:478
+#: ../../c-api/type.rst:481
 msgid "``Py_nb_add`` to set :c:member:`PyNumberMethods.nb_add`"
 msgstr ""
 
-#: ../../c-api/type.rst:479
+#: ../../c-api/type.rst:482
 msgid "``Py_sq_length`` to set :c:member:`PySequenceMethods.sq_length`"
 msgstr ""
 
-#: ../../c-api/type.rst:481
+#: ../../c-api/type.rst:484
 msgid ""
 "The following “offset” fields cannot be set using :c:type:`PyType_Slot`:"
 msgstr ""
 
-#: ../../c-api/type.rst:483
+#: ../../c-api/type.rst:486
 msgid ""
 ":c:member:`~PyTypeObject.tp_weaklistoffset` (use :c:macro:"
 "`Py_TPFLAGS_MANAGED_WEAKREF` instead if possible)"
 msgstr ""
 
-#: ../../c-api/type.rst:485
+#: ../../c-api/type.rst:488
 msgid ""
 ":c:member:`~PyTypeObject.tp_dictoffset` (use :c:macro:"
 "`Py_TPFLAGS_MANAGED_DICT` instead if possible)"
 msgstr ""
 ":c:member:`~PyTypeObject.tp_dictoffset`\\ （如果可能，請改用 :c:macro:"
 "`Py_TPFLAGS_MANAGED_DICT`）"
 
-#: ../../c-api/type.rst:487
+#: ../../c-api/type.rst:490
 msgid ""
 ":c:member:`~PyTypeObject.tp_vectorcall_offset` (use "
 "``\"__vectorcalloffset__\"`` in :ref:`PyMemberDef <pymemberdef-offsets>`)"
 msgstr ""
 ":c:member:`~PyTypeObject.tp_vectorcall_offset`\\ （請用 :ref:`PyMemberDef "
 "<pymemberdef-offsets>` 中的 ``\"__vectorcalloffset__\"``）"
 
-#: ../../c-api/type.rst:491
+#: ../../c-api/type.rst:494
 msgid ""
 "If it is not possible to switch to a ``MANAGED`` flag (for example, for "
 "vectorcall or to support Python older than 3.12), specify the offset in :c:"
 "member:`Py_tp_members <PyTypeObject.tp_members>`. See :ref:`PyMemberDef "
 "documentation <pymemberdef-offsets>` for details."
 msgstr ""
 
-#: ../../c-api/type.rst:497
+#: ../../c-api/type.rst:500
 msgid "The following fields cannot be set at all when creating a heap type:"
 msgstr ""
 
-#: ../../c-api/type.rst:499
+#: ../../c-api/type.rst:502
 msgid ""
 ":c:member:`~PyTypeObject.tp_vectorcall` (use :c:member:`~PyTypeObject."
 "tp_new` and/or :c:member:`~PyTypeObject.tp_init`)"
 msgstr ""
 
-#: ../../c-api/type.rst:503
+#: ../../c-api/type.rst:506
 msgid ""
 "Internal fields: :c:member:`~PyTypeObject.tp_dict`, :c:member:`~PyTypeObject."
 "tp_mro`, :c:member:`~PyTypeObject.tp_cache`, :c:member:`~PyTypeObject."
 "tp_subclasses`, and :c:member:`~PyTypeObject.tp_weaklist`."
 msgstr ""
 
-#: ../../c-api/type.rst:510
+#: ../../c-api/type.rst:513
 msgid ""
 "Setting :c:data:`Py_tp_bases` or :c:data:`Py_tp_base` may be problematic on "
 "some platforms. To avoid issues, use the *bases* argument of :c:func:"
 "`PyType_FromSpecWithBases` instead."
 msgstr ""
 
-#: ../../c-api/type.rst:515
+#: ../../c-api/type.rst:518
 msgid "Slots in :c:type:`PyBufferProcs` may be set in the unlimited API."
 msgstr ""
 
-#: ../../c-api/type.rst:518
+#: ../../c-api/type.rst:521
 msgid ""
 ":c:member:`~PyBufferProcs.bf_getbuffer` and :c:member:`~PyBufferProcs."
 "bf_releasebuffer` are now available under the :ref:`limited API <limited-c-"
 "api>`."
 msgstr ""
 
-#: ../../c-api/type.rst:525
+#: ../../c-api/type.rst:528
 msgid ""
 "The desired value of the slot. In most cases, this is a pointer to a "
 "function."
 msgstr ""
 
-#: ../../c-api/type.rst:528
+#: ../../c-api/type.rst:531
 msgid "Slots other than ``Py_tp_doc`` may not be ``NULL``."
 msgstr ""