Skip to content

Commit a2b66f2

Browse files
JulienPalardJulienPalard
authored
Make merge (#1655)
1 parent 4d36815 commit a2b66f2

19 files changed

+1660
-1582
lines changed

‎c-api/gcsupport.po

Lines changed: 43 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ msgid ""
55
msgstr ""
66
"Project-Id-Version: Python 3\n"
77
"Report-Msgid-Bugs-To: \n"
8-
"POT-Creation-Date: 2020-08-24 09:01+0200\n"
8+
"POT-Creation-Date: 2021-05-29 16:33+0200\n"
99
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
1010
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
1111
"Language-Team: FRENCH <traductions@lists.afpy.org>\n"
@@ -60,26 +60,44 @@ msgid ""
6060
"initialized, it must call :c:func:`PyObject_GC_Track`."
6161
msgstr ""
6262

63-
#: c-api/gcsupport.rst:39
63+
#: c-api/gcsupport.rst:37
64+
msgid ""
65+
"If a type adds the Py_TPFLAGS_HAVE_GC, then it *must* implement at least a :"
66+
"c:member:`~PyTypeObject.tp_traverse` handler or explicitly use one from its "
67+
"subclass or subclasses."
68+
msgstr ""
69+
70+
#: c-api/gcsupport.rst:41
71+
msgid ""
72+
"When calling :c:func:`PyType_Ready` or some of the APIs that indirectly call "
73+
"it like :c:func:`PyType_FromSpecWithBases` or :c:func:`PyType_FromSpec` the "
74+
"interpreter will automatically populate the :c:member:`~PyTypeObject."
75+
"tp_flags`, :c:member:`~PyTypeObject.tp_traverse` and :c:member:"
76+
"`~PyTypeObject.tp_clear` fields if the type inherits from a class that "
77+
"implements the garbage collector protocol and the child class does *not* "
78+
"include the :const:`Py_TPFLAGS_HAVE_GC` flag."
79+
msgstr ""
80+
81+
#: c-api/gcsupport.rst:51
6482
msgid ""
6583
"Analogous to :c:func:`PyObject_New` but for container objects with the :"
6684
"const:`Py_TPFLAGS_HAVE_GC` flag set."
6785
msgstr ""
6886

69-
#: c-api/gcsupport.rst:45
87+
#: c-api/gcsupport.rst:57
7088
msgid ""
7189
"Analogous to :c:func:`PyObject_NewVar` but for container objects with the :"
7290
"const:`Py_TPFLAGS_HAVE_GC` flag set."
7391
msgstr ""
7492

75-
#: c-api/gcsupport.rst:51
93+
#: c-api/gcsupport.rst:63
7694
msgid ""
7795
"Resize an object allocated by :c:func:`PyObject_NewVar`. Returns the "
7896
"resized object or ``NULL`` on failure. *op* must not be tracked by the "
7997
"collector yet."
8098
msgstr ""
8199

82-
#: c-api/gcsupport.rst:57
100+
#: c-api/gcsupport.rst:69
83101
msgid ""
84102
"Adds the object *op* to the set of container objects tracked by the "
85103
"collector. The collector can run at unexpected times so objects must be "
@@ -88,62 +106,62 @@ msgid ""
88106
"usually near the end of the constructor."
89107
msgstr ""
90108

91-
#: c-api/gcsupport.rst:66
109+
#: c-api/gcsupport.rst:78
92110
msgid ""
93111
"Returns non-zero if the object implements the garbage collector protocol, "
94112
"otherwise returns 0."
95113
msgstr ""
96114

97-
#: c-api/gcsupport.rst:69
115+
#: c-api/gcsupport.rst:81
98116
msgid ""
99117
"The object cannot be tracked by the garbage collector if this function "
100118
"returns 0."
101119
msgstr ""
102120

103-
#: c-api/gcsupport.rst:74
121+
#: c-api/gcsupport.rst:86
104122
msgid ""
105123
"Returns 1 if the object type of *op* implements the GC protocol and *op* is "
106124
"being currently tracked by the garbage collector and 0 otherwise."
107125
msgstr ""
108126

109-
#: c-api/gcsupport.rst:77
127+
#: c-api/gcsupport.rst:89
110128
msgid "This is analogous to the Python function :func:`gc.is_tracked`."
111129
msgstr ""
112130

113-
#: c-api/gcsupport.rst:84
131+
#: c-api/gcsupport.rst:96
114132
msgid ""
115133
"Returns 1 if the object type of *op* implements the GC protocol and *op* has "
116134
"been already finalized by the garbage collector and 0 otherwise."
117135
msgstr ""
118136

119-
#: c-api/gcsupport.rst:87
137+
#: c-api/gcsupport.rst:99
120138
msgid "This is analogous to the Python function :func:`gc.is_finalized`."
121139
msgstr ""
122140

123-
#: c-api/gcsupport.rst:91
141+
#: c-api/gcsupport.rst:103
124142
msgid ""
125143
"Similarly, the deallocator for the object must conform to a similar pair of "
126144
"rules:"
127145
msgstr ""
128146

129-
#: c-api/gcsupport.rst:94
147+
#: c-api/gcsupport.rst:106
130148
msgid ""
131149
"Before fields which refer to other containers are invalidated, :c:func:"
132150
"`PyObject_GC_UnTrack` must be called."
133151
msgstr ""
134152

135-
#: c-api/gcsupport.rst:97
153+
#: c-api/gcsupport.rst:109
136154
msgid ""
137155
"The object's memory must be deallocated using :c:func:`PyObject_GC_Del`."
138156
msgstr ""
139157

140-
#: c-api/gcsupport.rst:102
158+
#: c-api/gcsupport.rst:114
141159
msgid ""
142160
"Releases memory allocated to an object using :c:func:`PyObject_GC_New` or :c:"
143161
"func:`PyObject_GC_NewVar`."
144162
msgstr ""
145163

146-
#: c-api/gcsupport.rst:108
164+
#: c-api/gcsupport.rst:120
147165
msgid ""
148166
"Remove the object *op* from the set of container objects tracked by the "
149167
"collector. Note that :c:func:`PyObject_GC_Track` can be called again on "
@@ -153,19 +171,19 @@ msgid ""
153171
"handler become invalid."
154172
msgstr ""
155173

156-
#: c-api/gcsupport.rst:117
174+
#: c-api/gcsupport.rst:129
157175
msgid ""
158176
"The :c:func:`_PyObject_GC_TRACK` and :c:func:`_PyObject_GC_UNTRACK` macros "
159177
"have been removed from the public C API."
160178
msgstr ""
161179

162-
#: c-api/gcsupport.rst:120
180+
#: c-api/gcsupport.rst:132
163181
msgid ""
164182
"The :c:member:`~PyTypeObject.tp_traverse` handler accepts a function "
165183
"parameter of this type:"
166184
msgstr ""
167185

168-
#: c-api/gcsupport.rst:125
186+
#: c-api/gcsupport.rst:137
169187
msgid ""
170188
"Type of the visitor function passed to the :c:member:`~PyTypeObject."
171189
"tp_traverse` handler. The function should be called with an object to "
@@ -175,13 +193,13 @@ msgid ""
175193
"users will need to write their own visitor functions."
176194
msgstr ""
177195

178-
#: c-api/gcsupport.rst:132
196+
#: c-api/gcsupport.rst:144
179197
msgid ""
180198
"The :c:member:`~PyTypeObject.tp_traverse` handler must have the following "
181199
"type:"
182200
msgstr ""
183201

184-
#: c-api/gcsupport.rst:137
202+
#: c-api/gcsupport.rst:149
185203
msgid ""
186204
"Traversal function for a container object. Implementations must call the "
187205
"*visit* function for each object directly contained by *self*, with the "
@@ -191,28 +209,28 @@ msgid ""
191209
"returned immediately."
192210
msgstr ""
193211

194-
#: c-api/gcsupport.rst:144
212+
#: c-api/gcsupport.rst:156
195213
msgid ""
196214
"To simplify writing :c:member:`~PyTypeObject.tp_traverse` handlers, a :c:"
197215
"func:`Py_VISIT` macro is provided. In order to use this macro, the :c:"
198216
"member:`~PyTypeObject.tp_traverse` implementation must name its arguments "
199217
"exactly *visit* and *arg*:"
200218
msgstr ""
201219

202-
#: c-api/gcsupport.rst:151
220+
#: c-api/gcsupport.rst:163
203221
msgid ""
204222
"If *o* is not ``NULL``, call the *visit* callback, with arguments *o* and "
205223
"*arg*. If *visit* returns a non-zero value, then return it. Using this "
206224
"macro, :c:member:`~PyTypeObject.tp_traverse` handlers look like::"
207225
msgstr ""
208226

209-
#: c-api/gcsupport.rst:164
227+
#: c-api/gcsupport.rst:176
210228
msgid ""
211229
"The :c:member:`~PyTypeObject.tp_clear` handler must be of the :c:type:"
212230
"`inquiry` type, or ``NULL`` if the object is immutable."
213231
msgstr ""
214232

215-
#: c-api/gcsupport.rst:170
233+
#: c-api/gcsupport.rst:182
216234
msgid ""
217235
"Drop references that may have created reference cycles. Immutable objects "
218236
"do not have to define this method since they can never directly create "

0 commit comments

Comments
 (0)