sync with cpython 45e55991

Author: github-actions[bot]

c-api/gcsupport.po

@@ -7,7 +7,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.12\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2023-07-29 00:03+0000\n"
+"POT-Creation-Date: 2024-02-14 00:03+0000\n"
 "PO-Revision-Date: 2018-05-23 14:31+0000\n"
 "Last-Translator: Adrian Liaw <adrianliaw2000@gmail.com>\n"
 "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -139,12 +139,18 @@ msgstr ""
 
 #: ../../c-api/gcsupport.rst:88
 msgid ""
-"Resize an object allocated by :c:macro:`PyObject_NewVar`.  Returns the "
-"resized object or ``NULL`` on failure.  *op* must not be tracked by the "
-"collector yet."
+"Resize an object allocated by :c:macro:`PyObject_NewVar`. Returns the "
+"resized object of type ``TYPE*`` (refers to any C type) or ``NULL`` on "
+"failure."
 msgstr ""
 
-#: ../../c-api/gcsupport.rst:94
+#: ../../c-api/gcsupport.rst:92
+msgid ""
+"*op* must be of type :c:expr:`PyVarObject *` and must not be tracked by the "
+"collector yet. *newsize* must be of type :c:type:`Py_ssize_t`."
+msgstr ""
+
+#: ../../c-api/gcsupport.rst:99
 msgid ""
 "Adds the object *op* to the set of container objects tracked by the "
 "collector.  The collector can run at unexpected times so objects must be "
@@ -153,45 +159,45 @@ msgid ""
 "usually near the end of the constructor."
 msgstr ""
 
-#: ../../c-api/gcsupport.rst:103
+#: ../../c-api/gcsupport.rst:108
 msgid ""
 "Returns non-zero if the object implements the garbage collector protocol, "
 "otherwise returns 0."
 msgstr ""
 
-#: ../../c-api/gcsupport.rst:106
+#: ../../c-api/gcsupport.rst:111
 msgid ""
 "The object cannot be tracked by the garbage collector if this function "
 "returns 0."
 msgstr ""
 
-#: ../../c-api/gcsupport.rst:111
+#: ../../c-api/gcsupport.rst:116
 msgid ""
 "Returns 1 if the object type of *op* implements the GC protocol and *op* is "
 "being currently tracked by the garbage collector and 0 otherwise."
 msgstr ""
 
-#: ../../c-api/gcsupport.rst:114
+#: ../../c-api/gcsupport.rst:119
 msgid "This is analogous to the Python function :func:`gc.is_tracked`."
 msgstr ""
 
-#: ../../c-api/gcsupport.rst:121
+#: ../../c-api/gcsupport.rst:126
 msgid ""
 "Returns 1 if the object type of *op* implements the GC protocol and *op* has "
 "been already finalized by the garbage collector and 0 otherwise."
 msgstr ""
 
-#: ../../c-api/gcsupport.rst:124
+#: ../../c-api/gcsupport.rst:129
 msgid "This is analogous to the Python function :func:`gc.is_finalized`."
 msgstr ""
 
-#: ../../c-api/gcsupport.rst:131
+#: ../../c-api/gcsupport.rst:136
 msgid ""
 "Releases memory allocated to an object using :c:macro:`PyObject_GC_New` or :"
 "c:macro:`PyObject_GC_NewVar`."
 msgstr ""
 
-#: ../../c-api/gcsupport.rst:137
+#: ../../c-api/gcsupport.rst:142
 msgid ""
 "Remove the object *op* from the set of container objects tracked by the "
 "collector.  Note that :c:func:`PyObject_GC_Track` can be called again on "
@@ -201,19 +207,19 @@ msgid ""
 "handler become invalid."
 msgstr ""
 
-#: ../../c-api/gcsupport.rst:146
+#: ../../c-api/gcsupport.rst:151
 msgid ""
 "The :c:func:`!_PyObject_GC_TRACK` and :c:func:`!_PyObject_GC_UNTRACK` macros "
 "have been removed from the public C API."
 msgstr ""
 
-#: ../../c-api/gcsupport.rst:149
+#: ../../c-api/gcsupport.rst:154
 msgid ""
 "The :c:member:`~PyTypeObject.tp_traverse` handler accepts a function "
 "parameter of this type:"
 msgstr ""
 
-#: ../../c-api/gcsupport.rst:154
+#: ../../c-api/gcsupport.rst:159
 msgid ""
 "Type of the visitor function passed to the :c:member:`~PyTypeObject."
 "tp_traverse` handler. The function should be called with an object to "
@@ -223,13 +229,13 @@ msgid ""
 "users will need to write their own visitor functions."
 msgstr ""
 
-#: ../../c-api/gcsupport.rst:161
+#: ../../c-api/gcsupport.rst:166
 msgid ""
 "The :c:member:`~PyTypeObject.tp_traverse` handler must have the following "
 "type:"
 msgstr ""
 
-#: ../../c-api/gcsupport.rst:166
+#: ../../c-api/gcsupport.rst:171
 msgid ""
 "Traversal function for a container object.  Implementations must call the "
 "*visit* function for each object directly contained by *self*, with the "
@@ -239,28 +245,28 @@ msgid ""
 "returned immediately."
 msgstr ""
 
-#: ../../c-api/gcsupport.rst:173
+#: ../../c-api/gcsupport.rst:178
 msgid ""
 "To simplify writing :c:member:`~PyTypeObject.tp_traverse` handlers, a :c:"
 "func:`Py_VISIT` macro is provided.  In order to use this macro, the :c:"
 "member:`~PyTypeObject.tp_traverse` implementation must name its arguments "
 "exactly *visit* and *arg*:"
 msgstr ""
 
-#: ../../c-api/gcsupport.rst:180
+#: ../../c-api/gcsupport.rst:185
 msgid ""
 "If *o* is not ``NULL``, call the *visit* callback, with arguments *o* and "
 "*arg*.  If *visit* returns a non-zero value, then return it. Using this "
 "macro, :c:member:`~PyTypeObject.tp_traverse` handlers look like::"
 msgstr ""
 
-#: ../../c-api/gcsupport.rst:193
+#: ../../c-api/gcsupport.rst:198
 msgid ""
 "The :c:member:`~PyTypeObject.tp_clear` handler must be of the :c:type:"
 "`inquiry` type, or ``NULL`` if the object is immutable."
 msgstr ""
 
-#: ../../c-api/gcsupport.rst:199
+#: ../../c-api/gcsupport.rst:204
 msgid ""
 "Drop references that may have created reference cycles.  Immutable objects "
 "do not have to define this method since they can never directly create "
@@ -270,78 +276,78 @@ msgid ""
 "in a reference cycle."
 msgstr ""
 
-#: ../../c-api/gcsupport.rst:208
+#: ../../c-api/gcsupport.rst:213
 msgid "Controlling the Garbage Collector State"
 msgstr ""
 
-#: ../../c-api/gcsupport.rst:210
+#: ../../c-api/gcsupport.rst:215
 msgid ""
 "The C-API provides the following functions for controlling garbage "
 "collection runs."
 msgstr ""
 
-#: ../../c-api/gcsupport.rst:215
+#: ../../c-api/gcsupport.rst:220
 msgid ""
 "Perform a full garbage collection, if the garbage collector is enabled. "
 "(Note that :func:`gc.collect` runs it unconditionally.)"
 msgstr ""
 
-#: ../../c-api/gcsupport.rst:218
+#: ../../c-api/gcsupport.rst:223
 msgid ""
 "Returns the number of collected + unreachable objects which cannot be "
 "collected. If the garbage collector is disabled or already collecting, "
 "returns ``0`` immediately. Errors during garbage collection are passed to :"
 "data:`sys.unraisablehook`. This function does not raise exceptions."
 msgstr ""
 
-#: ../../c-api/gcsupport.rst:228
+#: ../../c-api/gcsupport.rst:233
 msgid ""
 "Enable the garbage collector: similar to :func:`gc.enable`. Returns the "
 "previous state, 0 for disabled and 1 for enabled."
 msgstr ""
 
-#: ../../c-api/gcsupport.rst:236
+#: ../../c-api/gcsupport.rst:241
 msgid ""
 "Disable the garbage collector: similar to :func:`gc.disable`. Returns the "
 "previous state, 0 for disabled and 1 for enabled."
 msgstr ""
 
-#: ../../c-api/gcsupport.rst:244
+#: ../../c-api/gcsupport.rst:249
 msgid ""
 "Query the state of the garbage collector: similar to :func:`gc.isenabled`. "
 "Returns the current state, 0 for disabled and 1 for enabled."
 msgstr ""
 
-#: ../../c-api/gcsupport.rst:251
+#: ../../c-api/gcsupport.rst:256
 msgid "Querying Garbage Collector State"
 msgstr ""
 
-#: ../../c-api/gcsupport.rst:253
+#: ../../c-api/gcsupport.rst:258
 msgid ""
 "The C-API provides the following interface for querying information about "
 "the garbage collector."
 msgstr ""
 
-#: ../../c-api/gcsupport.rst:258
+#: ../../c-api/gcsupport.rst:263
 msgid ""
 "Run supplied *callback* on all live GC-capable objects. *arg* is passed "
 "through to all invocations of *callback*."
 msgstr ""
 
-#: ../../c-api/gcsupport.rst:262
+#: ../../c-api/gcsupport.rst:267
 msgid ""
 "If new objects are (de)allocated by the callback it is undefined if they "
 "will be visited."
 msgstr ""
 
-#: ../../c-api/gcsupport.rst:265
+#: ../../c-api/gcsupport.rst:270
 msgid ""
 "Garbage collection is disabled during operation. Explicitly running a "
 "collection in the callback may lead to undefined behaviour e.g. visiting the "
 "same objects multiple times or not at all."
 msgstr ""
 
-#: ../../c-api/gcsupport.rst:273
+#: ../../c-api/gcsupport.rst:278
 msgid ""
 "Type of the visitor function to be passed to :c:func:"
 "`PyUnstable_GC_VisitObjects`. *arg* is the same as the *arg* passed to "