sync with cpython a8c3af08

Author: github-actions[bot]

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: 2025-04-03 00:14+0000\n"
+"POT-Creation-Date: 2025-06-20 00:15+0000\n"
 "PO-Revision-Date: 2015-12-09 17:51+0000\n"
 "Last-Translator: Liang-Bo Wang <me@liang2.tw>\n"
 "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -301,40 +301,47 @@ msgid ""
 "type:`PyCMethod` calling convention."
 msgstr ""
 
-#: ../../c-api/type.rst:274
+#: ../../c-api/type.rst:270
+msgid ""
+"The returned reference is :term:`borrowed <borrowed reference>` from *type*, "
+"and will be valid as long as you hold a reference to *type*. Do not release "
+"it with :c:func:`Py_DECREF` or similar."
+msgstr ""
+
+#: ../../c-api/type.rst:278
 msgid "Attempt to assign a version tag to the given type."
 msgstr ""
 
-#: ../../c-api/type.rst:276
+#: ../../c-api/type.rst:280
 msgid ""
 "Returns 1 if the type already had a valid version tag or a new one was "
 "assigned, or 0 if a new tag could not be assigned."
 msgstr ""
 
-#: ../../c-api/type.rst:283
+#: ../../c-api/type.rst:287
 msgid "Creating Heap-Allocated Types"
 msgstr ""
 
-#: ../../c-api/type.rst:285
+#: ../../c-api/type.rst:289
 msgid ""
 "The following functions and structs are used to create :ref:`heap types "
 "<heap-types>`."
 msgstr ""
 
-#: ../../c-api/type.rst:290
+#: ../../c-api/type.rst:294
 msgid ""
 "Create and return a :ref:`heap type <heap-types>` from the *spec* (see :c:"
 "macro:`Py_TPFLAGS_HEAPTYPE`)."
 msgstr ""
 
-#: ../../c-api/type.rst:293
+#: ../../c-api/type.rst:297
 msgid ""
 "The metaclass *metaclass* is used to construct the resulting type object. "
 "When *metaclass* is ``NULL``, the metaclass is derived from *bases* (or "
 "*Py_tp_base[s]* slots if *bases* is ``NULL``, see below)."
 msgstr ""
 
-#: ../../c-api/type.rst:297
+#: ../../c-api/type.rst:301
 msgid ""
 "Metaclasses that override :c:member:`~PyTypeObject.tp_new` are not "
 "supported, except if ``tp_new`` is ``NULL``. (For backwards compatibility, "
@@ -343,7 +350,7 @@ msgid ""
 "deprecated and in Python 3.14+ such metaclasses will not be supported.)"
 msgstr ""
 
-#: ../../c-api/type.rst:304
+#: ../../c-api/type.rst:308
 msgid ""
 "The *bases* argument can be used to specify base classes; it can either be "
 "only one class or a tuple of classes. If *bases* is ``NULL``, the "
@@ -352,7 +359,7 @@ msgid ""
 "derives from :class:`object`."
 msgstr ""
 
-#: ../../c-api/type.rst:310
+#: ../../c-api/type.rst:314
 msgid ""
 "The *module* argument can be used to record the module in which the new "
 "class is defined. It must be a module object or ``NULL``. If not ``NULL``, "
@@ -361,11 +368,11 @@ msgid ""
 "subclasses; it must be specified for each class individually."
 msgstr ""
 
-#: ../../c-api/type.rst:317
+#: ../../c-api/type.rst:321
 msgid "This function calls :c:func:`PyType_Ready` on the new type."
 msgstr ""
 
-#: ../../c-api/type.rst:319
+#: ../../c-api/type.rst:323
 msgid ""
 "Note that this function does *not* fully match the behavior of calling :py:"
 "class:`type() <type>` or using the :keyword:`class` statement. With user-"
@@ -374,84 +381,84 @@ msgid ""
 "Specifically:"
 msgstr ""
 
-#: ../../c-api/type.rst:326
+#: ../../c-api/type.rst:330
 msgid ""
 ":py:meth:`~object.__new__` is not called on the new class (and it must be "
 "set to ``type.__new__``)."
 msgstr ""
 
-#: ../../c-api/type.rst:328
+#: ../../c-api/type.rst:332
 msgid ":py:meth:`~object.__init__` is not called on the new class."
 msgstr ""
 
-#: ../../c-api/type.rst:329
+#: ../../c-api/type.rst:333
 msgid ":py:meth:`~object.__init_subclass__` is not called on any bases."
 msgstr ""
 
-#: ../../c-api/type.rst:330
+#: ../../c-api/type.rst:334
 msgid ":py:meth:`~object.__set_name__` is not called on new descriptors."
 msgstr ""
 
-#: ../../c-api/type.rst:336
+#: ../../c-api/type.rst:340
 msgid "Equivalent to ``PyType_FromMetaclass(NULL, module, spec, bases)``."
 msgstr "等價於 ``PyType_FromMetaclass(NULL, module, spec, bases)``。"
 
-#: ../../c-api/type.rst:342
+#: ../../c-api/type.rst:346
 msgid ""
 "The function now accepts a single class as the *bases* argument and ``NULL`` "
 "as the ``tp_doc`` slot."
 msgstr ""
 
-#: ../../c-api/type.rst:347 ../../c-api/type.rst:364
+#: ../../c-api/type.rst:351 ../../c-api/type.rst:368
 msgid ""
 "The function now finds and uses a metaclass corresponding to the provided "
 "base classes.  Previously, only :class:`type` instances were returned."
 msgstr ""
 
-#: ../../c-api/type.rst:350 ../../c-api/type.rst:367 ../../c-api/type.rst:383
+#: ../../c-api/type.rst:354 ../../c-api/type.rst:371 ../../c-api/type.rst:387
 msgid ""
 "The :c:member:`~PyTypeObject.tp_new` of the metaclass is *ignored*. which "
 "may result in incomplete initialization. Creating classes whose metaclass "
 "overrides :c:member:`~PyTypeObject.tp_new` is deprecated and in Python 3.14+ "
 "it will be no longer allowed."
 msgstr ""
 
-#: ../../c-api/type.rst:358
+#: ../../c-api/type.rst:362
 msgid "Equivalent to ``PyType_FromMetaclass(NULL, NULL, spec, bases)``."
 msgstr "等價於 ``PyType_FromMetaclass(NULL, NULL, spec, bases)``。"
 
-#: ../../c-api/type.rst:375
+#: ../../c-api/type.rst:379
 msgid "Equivalent to ``PyType_FromMetaclass(NULL, NULL, spec, NULL)``."
 msgstr "等價於 ``PyType_FromMetaclass(NULL, NULL, spec, NULL)``。"
 
-#: ../../c-api/type.rst:379
+#: ../../c-api/type.rst:383
 msgid ""
 "The function now finds and uses a metaclass corresponding to the base "
 "classes provided in *Py_tp_base[s]* slots. Previously, only :class:`type` "
 "instances were returned."
 msgstr ""
 
-#: ../../c-api/type.rst:400
+#: ../../c-api/type.rst:404
 msgid "Structure defining a type's behavior."
 msgstr ""
 
-#: ../../c-api/type.rst:404
+#: ../../c-api/type.rst:408
 msgid "Name of the type, used to set :c:member:`PyTypeObject.tp_name`."
 msgstr ""
 
-#: ../../c-api/type.rst:408
+#: ../../c-api/type.rst:412
 msgid ""
 "If positive, specifies the size of the instance in bytes. It is used to set :"
 "c:member:`PyTypeObject.tp_basicsize`."
 msgstr ""
 
-#: ../../c-api/type.rst:411
+#: ../../c-api/type.rst:415
 msgid ""
 "If zero, specifies that :c:member:`~PyTypeObject.tp_basicsize` should be "
 "inherited."
 msgstr ""
 
-#: ../../c-api/type.rst:414
+#: ../../c-api/type.rst:418
 msgid ""
 "If negative, the absolute value specifies how much space instances of the "
 "class need *in addition* to the superclass. Use :c:func:"
@@ -461,17 +468,17 @@ msgid ""
 "requirements."
 msgstr ""
 
-#: ../../c-api/type.rst:424
+#: ../../c-api/type.rst:428
 msgid "Previously, this field could not be negative."
 msgstr ""
 
-#: ../../c-api/type.rst:428
+#: ../../c-api/type.rst:432
 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:432
+#: ../../c-api/type.rst:436
 msgid ""
 "If zero, :c:member:`~PyTypeObject.tp_itemsize` is inherited. Extending "
 "arbitrary variable-sized classes is dangerous, since some types use a fixed "
@@ -480,154 +487,154 @@ msgid ""
 "only possible in the following situations:"
 msgstr ""
 
-#: ../../c-api/type.rst:439
+#: ../../c-api/type.rst:443
 msgid ""
 "The base is not variable-sized (its :c:member:`~PyTypeObject.tp_itemsize`)."
 msgstr ""
 
-#: ../../c-api/type.rst:441
+#: ../../c-api/type.rst:445
 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:443
+#: ../../c-api/type.rst:447
 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:446
+#: ../../c-api/type.rst:450
 msgid "With the :c:macro:`Py_TPFLAGS_ITEMS_AT_END` flag."
 msgstr ""
 
-#: ../../c-api/type.rst:450
+#: ../../c-api/type.rst:454
 msgid "Type flags, used to set :c:member:`PyTypeObject.tp_flags`."
 msgstr ""
 
-#: ../../c-api/type.rst:452
+#: ../../c-api/type.rst:456
 msgid ""
 "If the ``Py_TPFLAGS_HEAPTYPE`` flag is not set, :c:func:"
 "`PyType_FromSpecWithBases` sets it automatically."
 msgstr ""
 
-#: ../../c-api/type.rst:457
+#: ../../c-api/type.rst:461
 msgid ""
 "Array of :c:type:`PyType_Slot` structures. Terminated by the special slot "
 "value ``{0, NULL}``."
 msgstr ""
 
-#: ../../c-api/type.rst:460
+#: ../../c-api/type.rst:464
 msgid "Each slot ID should be specified at most once."
 msgstr ""
 
-#: ../../c-api/type.rst:470
+#: ../../c-api/type.rst:474
 msgid ""
 "Structure defining optional functionality of a type, containing a slot ID "
 "and a value pointer."
 msgstr ""
 
-#: ../../c-api/type.rst:475
+#: ../../c-api/type.rst:479
 msgid "A slot ID."
 msgstr ""
 
-#: ../../c-api/type.rst:477
+#: ../../c-api/type.rst:481
 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:483
+#: ../../c-api/type.rst:487
 msgid "``Py_tp_dealloc`` to set :c:member:`PyTypeObject.tp_dealloc`"
 msgstr ""
 
-#: ../../c-api/type.rst:484
+#: ../../c-api/type.rst:488
 msgid "``Py_nb_add`` to set :c:member:`PyNumberMethods.nb_add`"
 msgstr ""
 
-#: ../../c-api/type.rst:485
+#: ../../c-api/type.rst:489
 msgid "``Py_sq_length`` to set :c:member:`PySequenceMethods.sq_length`"
 msgstr ""
 
-#: ../../c-api/type.rst:487
+#: ../../c-api/type.rst:491
 msgid ""
 "The following “offset” fields cannot be set using :c:type:`PyType_Slot`:"
 msgstr ""
 
-#: ../../c-api/type.rst:489
+#: ../../c-api/type.rst:493
 msgid ""
 ":c:member:`~PyTypeObject.tp_weaklistoffset` (use :c:macro:"
 "`Py_TPFLAGS_MANAGED_WEAKREF` instead if possible)"
 msgstr ""
 
-#: ../../c-api/type.rst:491
+#: ../../c-api/type.rst:495
 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:493
+#: ../../c-api/type.rst:497
 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:497
+#: ../../c-api/type.rst:501
 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:503
+#: ../../c-api/type.rst:507
 msgid "The following fields cannot be set at all when creating a heap type:"
 msgstr ""
 
-#: ../../c-api/type.rst:505
+#: ../../c-api/type.rst:509
 msgid ""
 ":c:member:`~PyTypeObject.tp_vectorcall` (use :c:member:`~PyTypeObject."
 "tp_new` and/or :c:member:`~PyTypeObject.tp_init`)"
 msgstr ""
 
-#: ../../c-api/type.rst:509
+#: ../../c-api/type.rst:513
 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:516
+#: ../../c-api/type.rst:520
 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:521
+#: ../../c-api/type.rst:525
 msgid "Slots in :c:type:`PyBufferProcs` may be set in the unlimited API."
 msgstr ""
 
-#: ../../c-api/type.rst:524
+#: ../../c-api/type.rst:528
 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:531
+#: ../../c-api/type.rst:535
 msgid ""
 "The desired value of the slot. In most cases, this is a pointer to a "
 "function."
 msgstr ""
 
-#: ../../c-api/type.rst:534
+#: ../../c-api/type.rst:538
 msgid "Slots other than ``Py_tp_doc`` may not be ``NULL``."
 msgstr ""