Skip to content

Commit 26e0fc2

Browse files
Get changes from CPython Doc for 3.12
1 parent 74bc013 commit 26e0fc2

File tree

138 files changed

+8845
-8140
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

138 files changed

+8845
-8140
lines changed

Makefile

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@
1919
# test build, we're building with the .rst files that generated our
2020
# .po files.
2121

22-
CPYTHON_CURRENT_COMMIT := d3f2051eec6039811ae42e4382e8b292a983edc1
22+
CPYTHON_CURRENT_COMMIT := 67688609d21c759295b773407057724581a1e3c2
2323
LANGUAGE := tr
2424
BRANCH := 3.12
2525

c-api/buffer.po

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ msgid ""
77
msgstr ""
88
"Project-Id-Version: Python 3.12\n"
99
"Report-Msgid-Bugs-To: \n"
10-
"POT-Creation-Date: 2023-09-18 19:05+0000\n"
10+
"POT-Creation-Date: 2024-02-11 20:24+0000\n"
1111
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
1212
"Last-Translator: \n"
1313
"Language-Team: TURKISH <python.docs.tr@gmail.com>\n"
@@ -689,7 +689,7 @@ msgid "buffer object"
689689
msgstr ""
690690

691691
#: c-api/buffer.rst:32
692-
msgid "PyBufferProcs"
692+
msgid "PyBufferProcs (C type)"
693693
msgstr ""
694694

695695
#: c-api/buffer.rst:294

c-api/code.po

Lines changed: 59 additions & 59 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ msgid ""
77
msgstr ""
88
"Project-Id-Version: Python 3.12\n"
99
"Report-Msgid-Bugs-To: \n"
10-
"POT-Creation-Date: 2023-09-18 22:33+0300\n"
10+
"POT-Creation-Date: 2024-02-11 20:24+0000\n"
1111
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
1212
"Last-Translator: \n"
1313
"Language-Team: TURKISH <python.docs.tr@gmail.com>\n"
@@ -35,181 +35,181 @@ msgstr ""
3535

3636
#: c-api/code.rst:24
3737
msgid ""
38-
"This is an instance of :c:type:`PyTypeObject` representing the Python :class:"
39-
"`code` type."
38+
"This is an instance of :c:type:`PyTypeObject` representing the Python :ref:"
39+
"`code object <code-objects>`."
4040
msgstr ""
4141

4242
#: c-api/code.rst:30
4343
msgid ""
44-
"Return true if *co* is a :class:`code` object. This function always "
45-
"succeeds."
44+
"Return true if *co* is a :ref:`code object <code-objects>`. This function "
45+
"always succeeds."
4646
msgstr ""
4747

48-
#: c-api/code.rst:34
48+
#: c-api/code.rst:35
4949
msgid "Return the number of free variables in *co*."
5050
msgstr ""
5151

52-
#: c-api/code.rst:38
52+
#: c-api/code.rst:39
5353
msgid ""
5454
"Return a new code object. If you need a dummy code object to create a "
5555
"frame, use :c:func:`PyCode_NewEmpty` instead."
5656
msgstr ""
5757

58-
#: c-api/code.rst:41
58+
#: c-api/code.rst:42
5959
msgid ""
6060
"Since the definition of the bytecode changes often, calling :c:func:"
6161
"`PyUnstable_Code_New` directly can bind you to a precise Python version."
6262
msgstr ""
6363

64-
#: c-api/code.rst:44
64+
#: c-api/code.rst:45
6565
msgid ""
6666
"The many arguments of this function are inter-dependent in complex ways, "
6767
"meaning that subtle changes to values are likely to result in incorrect "
6868
"execution or VM crashes. Use this function only with extreme care."
6969
msgstr ""
7070

71-
#: c-api/code.rst:48
71+
#: c-api/code.rst:49
7272
msgid "Added ``qualname`` and ``exceptiontable`` parameters."
7373
msgstr ""
7474

75-
#: c-api/code.rst:55
75+
#: c-api/code.rst:56
7676
msgid ""
7777
"Renamed from ``PyCode_New`` as part of :ref:`unstable-c-api`. The old name "
7878
"is deprecated, but will remain available until the signature changes again."
7979
msgstr ""
8080

81-
#: c-api/code.rst:61
81+
#: c-api/code.rst:62
8282
msgid ""
8383
"Similar to :c:func:`PyUnstable_Code_New`, but with an extra "
8484
"\"posonlyargcount\" for positional-only arguments. The same caveats that "
8585
"apply to ``PyUnstable_Code_New`` also apply to this function."
8686
msgstr ""
8787

88-
#: c-api/code.rst:66
88+
#: c-api/code.rst:67
8989
msgid "as ``PyCode_NewWithPosOnlyArgs``"
9090
msgstr ""
9191

92-
#: c-api/code.rst:68
92+
#: c-api/code.rst:69
9393
msgid "Added ``qualname`` and ``exceptiontable`` parameters."
9494
msgstr ""
9595

96-
#: c-api/code.rst:73
96+
#: c-api/code.rst:74
9797
msgid ""
9898
"Renamed to ``PyUnstable_Code_NewWithPosOnlyArgs``. The old name is "
9999
"deprecated, but will remain available until the signature changes again."
100100
msgstr ""
101101

102-
#: c-api/code.rst:79
102+
#: c-api/code.rst:80
103103
msgid ""
104104
"Return a new empty code object with the specified filename, function name, "
105105
"and first line number. The resulting code object will raise an ``Exception`` "
106106
"if executed."
107107
msgstr ""
108108

109-
#: c-api/code.rst:85
109+
#: c-api/code.rst:86
110110
msgid ""
111111
"Return the line number of the instruction that occurs on or before "
112112
"``byte_offset`` and ends after it. If you just need the line number of a "
113113
"frame, use :c:func:`PyFrame_GetLineNumber` instead."
114114
msgstr ""
115115

116-
#: c-api/code.rst:88
116+
#: c-api/code.rst:89
117117
msgid ""
118118
"For efficiently iterating over the line numbers in a code object, use `the "
119119
"API described in PEP 626 <https://peps.python.org/pep-0626/#out-of-process-"
120120
"debuggers-and-profilers>`_."
121121
msgstr ""
122122

123-
#: c-api/code.rst:93
123+
#: c-api/code.rst:94
124124
msgid ""
125125
"Sets the passed ``int`` pointers to the source code line and column numbers "
126126
"for the instruction at ``byte_offset``. Sets the value to ``0`` when "
127127
"information is not available for any particular element."
128128
msgstr ""
129129

130-
#: c-api/code.rst:97
130+
#: c-api/code.rst:98
131131
msgid "Returns ``1`` if the function succeeds and 0 otherwise."
132132
msgstr ""
133133

134-
#: c-api/code.rst:103
134+
#: c-api/code.rst:104
135135
msgid ""
136136
"Equivalent to the Python code ``getattr(co, 'co_code')``. Returns a strong "
137137
"reference to a :c:type:`PyBytesObject` representing the bytecode in a code "
138138
"object. On error, ``NULL`` is returned and an exception is raised."
139139
msgstr ""
140140

141-
#: c-api/code.rst:108
141+
#: c-api/code.rst:109
142142
msgid ""
143143
"This ``PyBytesObject`` may be created on-demand by the interpreter and does "
144144
"not necessarily represent the bytecode actually executed by CPython. The "
145145
"primary use case for this function is debuggers and profilers."
146146
msgstr ""
147147

148-
#: c-api/code.rst:116
148+
#: c-api/code.rst:117
149149
msgid ""
150150
"Equivalent to the Python code ``getattr(co, 'co_varnames')``. Returns a new "
151151
"reference to a :c:type:`PyTupleObject` containing the names of the local "
152152
"variables. On error, ``NULL`` is returned and an exception is raised."
153153
msgstr ""
154154

155-
#: c-api/code.rst:125
155+
#: c-api/code.rst:126
156156
msgid ""
157157
"Equivalent to the Python code ``getattr(co, 'co_cellvars')``. Returns a new "
158158
"reference to a :c:type:`PyTupleObject` containing the names of the local "
159159
"variables that are referenced by nested functions. On error, ``NULL`` is "
160160
"returned and an exception is raised."
161161
msgstr ""
162162

163-
#: c-api/code.rst:134
163+
#: c-api/code.rst:135
164164
msgid ""
165165
"Equivalent to the Python code ``getattr(co, 'co_freevars')``. Returns a new "
166166
"reference to a :c:type:`PyTupleObject` containing the names of the free "
167167
"variables. On error, ``NULL`` is returned and an exception is raised."
168168
msgstr ""
169169

170-
#: c-api/code.rst:142
170+
#: c-api/code.rst:143
171171
msgid ""
172172
"Register *callback* as a code object watcher for the current interpreter. "
173173
"Return an ID which may be passed to :c:func:`PyCode_ClearWatcher`. In case "
174174
"of error (e.g. no more watcher IDs available), return ``-1`` and set an "
175175
"exception."
176176
msgstr ""
177177

178-
#: c-api/code.rst:151
178+
#: c-api/code.rst:152
179179
msgid ""
180180
"Clear watcher identified by *watcher_id* previously returned from :c:func:"
181181
"`PyCode_AddWatcher` for the current interpreter. Return ``0`` on success, or "
182182
"``-1`` and set an exception on error (e.g. if the given *watcher_id* was "
183183
"never registered.)"
184184
msgstr ""
185185

186-
#: c-api/code.rst:160
186+
#: c-api/code.rst:161
187187
msgid ""
188188
"Enumeration of possible code object watcher events: - "
189189
"``PY_CODE_EVENT_CREATE`` - ``PY_CODE_EVENT_DESTROY``"
190190
msgstr ""
191191

192-
#: c-api/code.rst:168
192+
#: c-api/code.rst:169
193193
msgid "Type of a code object watcher callback function."
194194
msgstr ""
195195

196-
#: c-api/code.rst:170
196+
#: c-api/code.rst:171
197197
msgid ""
198198
"If *event* is ``PY_CODE_EVENT_CREATE``, then the callback is invoked after "
199199
"`co` has been fully initialized. Otherwise, the callback is invoked before "
200200
"the destruction of *co* takes place, so the prior state of *co* can be "
201201
"inspected."
202202
msgstr ""
203203

204-
#: c-api/code.rst:175
204+
#: c-api/code.rst:176
205205
msgid ""
206206
"If *event* is ``PY_CODE_EVENT_DESTROY``, taking a reference in the callback "
207207
"to the about-to-be-destroyed code object will resurrect it and prevent it "
208208
"from being freed at this time. When the resurrected object is destroyed "
209209
"later, any watcher callbacks active at that time will be called again."
210210
msgstr ""
211211

212-
#: c-api/code.rst:180
212+
#: c-api/code.rst:181
213213
msgid ""
214214
"Users of this API should not rely on internal runtime implementation "
215215
"details. Such details may include, but are not limited to, the exact order "
@@ -219,14 +219,14 @@ msgid ""
219219
"the Python code being executed."
220220
msgstr ""
221221

222-
#: c-api/code.rst:187
222+
#: c-api/code.rst:188
223223
msgid ""
224224
"If the callback sets an exception, it must return ``-1``; this exception "
225225
"will be printed as an unraisable exception using :c:func:"
226226
"`PyErr_WriteUnraisable`. Otherwise it should return ``0``."
227227
msgstr ""
228228

229-
#: c-api/code.rst:191
229+
#: c-api/code.rst:192
230230
msgid ""
231231
"There may already be a pending exception set on entry to the callback. In "
232232
"this case, the callback should return ``0`` with the same exception still "
@@ -235,85 +235,85 @@ msgid ""
235235
"it before returning."
236236
msgstr ""
237237

238-
#: c-api/code.rst:201
238+
#: c-api/code.rst:202
239239
msgid "Extra information"
240240
msgstr ""
241241

242-
#: c-api/code.rst:203
242+
#: c-api/code.rst:204
243243
msgid ""
244244
"To support low-level extensions to frame evaluation, such as external just-"
245245
"in-time compilers, it is possible to attach arbitrary extra data to code "
246246
"objects."
247247
msgstr ""
248248

249-
#: c-api/code.rst:207
249+
#: c-api/code.rst:208
250250
msgid ""
251251
"These functions are part of the unstable C API tier: this functionality is a "
252252
"CPython implementation detail, and the API may change without deprecation "
253253
"warnings."
254254
msgstr ""
255255

256-
#: c-api/code.rst:213
256+
#: c-api/code.rst:214
257257
msgid "Return a new an opaque index value used to adding data to code objects."
258258
msgstr ""
259259

260-
#: c-api/code.rst:215
260+
#: c-api/code.rst:216
261261
msgid ""
262262
"You generally call this function once (per interpreter) and use the result "
263263
"with ``PyCode_GetExtra`` and ``PyCode_SetExtra`` to manipulate data on "
264264
"individual code objects."
265265
msgstr ""
266266

267-
#: c-api/code.rst:219
267+
#: c-api/code.rst:220
268268
msgid ""
269269
"If *free* is not ``NULL``: when a code object is deallocated, *free* will be "
270270
"called on non-``NULL`` data stored under the new index. Use :c:func:"
271271
"`Py_DecRef` when storing :c:type:`PyObject`."
272272
msgstr ""
273273

274-
#: c-api/code.rst:225
274+
#: c-api/code.rst:226
275275
msgid "as ``_PyEval_RequestCodeExtraIndex``"
276276
msgstr ""
277277

278-
#: c-api/code.rst:229
278+
#: c-api/code.rst:230
279279
msgid ""
280280
"Renamed to ``PyUnstable_Eval_RequestCodeExtraIndex``. The old private name "
281281
"is deprecated, but will be available until the API changes."
282282
msgstr ""
283283

284-
#: c-api/code.rst:235
284+
#: c-api/code.rst:236
285285
msgid ""
286286
"Set *extra* to the extra data stored under the given index. Return 0 on "
287287
"success. Set an exception and return -1 on failure."
288288
msgstr ""
289289

290-
#: c-api/code.rst:238
290+
#: c-api/code.rst:239
291291
msgid ""
292292
"If no data was set under the index, set *extra* to ``NULL`` and return 0 "
293293
"without setting an exception."
294294
msgstr ""
295295

296-
#: c-api/code.rst:243
296+
#: c-api/code.rst:244
297297
msgid "as ``_PyCode_GetExtra``"
298298
msgstr ""
299299

300-
#: c-api/code.rst:247
300+
#: c-api/code.rst:248
301301
msgid ""
302302
"Renamed to ``PyUnstable_Code_GetExtra``. The old private name is deprecated, "
303303
"but will be available until the API changes."
304304
msgstr ""
305305

306-
#: c-api/code.rst:253
306+
#: c-api/code.rst:254
307307
msgid ""
308308
"Set the extra data stored under the given index to *extra*. Return 0 on "
309309
"success. Set an exception and return -1 on failure."
310310
msgstr ""
311311

312-
#: c-api/code.rst:258
312+
#: c-api/code.rst:259
313313
msgid "as ``_PyCode_SetExtra``"
314314
msgstr ""
315315

316-
#: c-api/code.rst:262
316+
#: c-api/code.rst:263
317317
msgid ""
318318
"Renamed to ``PyUnstable_Code_SetExtra``. The old private name is deprecated, "
319319
"but will be available until the API changes."
@@ -331,22 +331,22 @@ msgstr ""
331331
msgid "code object"
332332
msgstr ""
333333

334-
#: c-api/code.rst:51
335-
msgid "PyCode_New"
334+
#: c-api/code.rst:52
335+
msgid "PyCode_New (C function)"
336336
msgstr ""
337337

338-
#: c-api/code.rst:64
339-
msgid "PyCode_NewWithPosOnlyArgs"
338+
#: c-api/code.rst:65
339+
msgid "PyCode_NewWithPosOnlyArgs (C function)"
340340
msgstr ""
341341

342-
#: c-api/code.rst:223
343-
msgid "_PyEval_RequestCodeExtraIndex"
342+
#: c-api/code.rst:224
343+
msgid "_PyEval_RequestCodeExtraIndex (C function)"
344344
msgstr ""
345345

346-
#: c-api/code.rst:241
347-
msgid "_PyCode_GetExtra"
346+
#: c-api/code.rst:242
347+
msgid "_PyCode_GetExtra (C function)"
348348
msgstr ""
349349

350-
#: c-api/code.rst:256
351-
msgid "_PyCode_SetExtra"
350+
#: c-api/code.rst:257
351+
msgid "_PyCode_SetExtra (C function)"
352352
msgstr ""

0 commit comments

Comments
 (0)