Skip to content

Commit ee77dd0

Browse files
author
GitHub Action's update-translation job
committed
Update translation from Transifex
1 parent 536062a commit ee77dd0

Some content is hidden

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

47 files changed

+2630
-2323
lines changed

‎README.en.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ f'''![build](https://github.com/python/python-docs-pl/actions/workflows/update-l
1313
![{translators} Translators](https://img.shields.io/badge/Translators-{translators}-0.svg)''')
1414
]]] -->
1515
![build](https://github.com/python/python-docs-pl/actions/workflows/update-lint-and-build.yml/badge.svg)
16-
![Total Translation of Documentation](https://img.shields.io/badge/Total-5.775%25-0.svg)
16+
![Total Translation of Documentation](https://img.shields.io/badge/Total-5.278%25-0.svg)
1717
![24 Translators](https://img.shields.io/badge/Translators-24-0.svg)
1818
<!-- [[[end]]] -->
1919

‎README.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ f'''![build](https://github.com/python/python-docs-pl/actions/workflows/update-l
1313
![{translators} tłumaczy](https://img.shields.io/badge/tłumaczy-{translators}-0.svg)''')
1414
]]] -->
1515
![build](https://github.com/python/python-docs-pl/actions/workflows/update-lint-and-build.yml/badge.svg)
16-
![postęp tłumaczenia całości dokumentacji](https://img.shields.io/badge/całość-5.775%25-0.svg)
16+
![postęp tłumaczenia całości dokumentacji](https://img.shields.io/badge/całość-5.278%25-0.svg)
1717
![24 tłumaczy](https://img.shields.io/badge/tłumaczy-24-0.svg)
1818
<!-- [[[end]]] -->
1919

‎c-api/allocation.po‎

Lines changed: 110 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -6,15 +6,16 @@
66
# Translators:
77
# haaritsubaki, 2023
88
# Waldemar Stoczkowski, 2023
9+
# Stan Ulbrych, 2025
910
#
1011
#, fuzzy
1112
msgid ""
1213
msgstr ""
1314
"Project-Id-Version: Python 3.14\n"
1415
"Report-Msgid-Bugs-To: \n"
15-
"POT-Creation-Date: 2025-05-08 02:53-0300\n"
16+
"POT-Creation-Date: 2025-05-23 14:20+0000\n"
1617
"PO-Revision-Date: 2021-06-28 00:47+0000\n"
17-
"Last-Translator: Waldemar Stoczkowski, 2023\n"
18+
"Last-Translator: Stan Ulbrych, 2025\n"
1819
"Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n"
1920
"MIME-Version: 1.0\n"
2021
"Content-Type: text/plain; charset=UTF-8\n"
@@ -30,7 +31,22 @@ msgstr "Przydzielanie obiektów na stercie"
3031
msgid ""
3132
"Initialize a newly allocated object *op* with its type and initial "
3233
"reference. Returns the initialized object. Other fields of the object are "
33-
"not affected."
34+
"not initialized. Despite its name, this function is unrelated to the "
35+
"object's :meth:`~object.__init__` method (:c:member:`~PyTypeObject.tp_init` "
36+
"slot). Specifically, this function does **not** call the object's :meth:`!"
37+
"__init__` method."
38+
msgstr ""
39+
40+
msgid ""
41+
"In general, consider this function to be a low-level routine. Use :c:member:"
42+
"`~PyTypeObject.tp_alloc` where possible. For implementing :c:member:`!"
43+
"tp_alloc` for your type, prefer :c:func:`PyType_GenericAlloc` or :c:func:"
44+
"`PyObject_New`."
45+
msgstr ""
46+
47+
msgid ""
48+
"This function only initializes the object's memory corresponding to the "
49+
"initial :c:type:`PyObject` structure. It does not zero the rest."
3450
msgstr ""
3551

3652
msgid ""
@@ -41,36 +57,106 @@ msgstr ""
4157
"zainicjuje informacje o długości dla obiektu o zmiennym rozmiarze."
4258

4359
msgid ""
44-
"Allocate a new Python object using the C structure type *TYPE* and the "
45-
"Python type object *typeobj* (``PyTypeObject*``). Fields not defined by the "
46-
"Python object header are not initialized. The caller will own the only "
47-
"reference to the object (i.e. its reference count will be one). The size of "
48-
"the memory allocation is determined from the :c:member:`~PyTypeObject."
49-
"tp_basicsize` field of the type object."
60+
"This function only initializes some of the object's memory. It does not "
61+
"zero the rest."
62+
msgstr ""
63+
64+
msgid ""
65+
"Allocates a new Python object using the C structure type *TYPE* and the "
66+
"Python type object *typeobj* (``PyTypeObject*``) by calling :c:func:"
67+
"`PyObject_Malloc` to allocate memory and initializing it like :c:func:"
68+
"`PyObject_Init`. The caller will own the only reference to the object (i.e. "
69+
"its reference count will be one)."
70+
msgstr ""
71+
72+
msgid ""
73+
"Avoid calling this directly to allocate memory for an object; call the "
74+
"type's :c:member:`~PyTypeObject.tp_alloc` slot instead."
75+
msgstr ""
76+
77+
msgid ""
78+
"When populating a type's :c:member:`~PyTypeObject.tp_alloc` slot, :c:func:"
79+
"`PyType_GenericAlloc` is preferred over a custom function that simply calls "
80+
"this macro."
81+
msgstr ""
82+
83+
msgid ""
84+
"This macro does not call :c:member:`~PyTypeObject.tp_alloc`, :c:member:"
85+
"`~PyTypeObject.tp_new` (:meth:`~object.__new__`), or :c:member:"
86+
"`~PyTypeObject.tp_init` (:meth:`~object.__init__`)."
87+
msgstr ""
88+
89+
msgid ""
90+
"This cannot be used for objects with :c:macro:`Py_TPFLAGS_HAVE_GC` set in :c:"
91+
"member:`~PyTypeObject.tp_flags`; use :c:macro:`PyObject_GC_New` instead."
92+
msgstr ""
93+
94+
msgid ""
95+
"Memory allocated by this macro must be freed with :c:func:`PyObject_Free` "
96+
"(usually called via the object's :c:member:`~PyTypeObject.tp_free` slot)."
97+
msgstr ""
98+
99+
msgid ""
100+
"The returned memory is not guaranteed to have been completely zeroed before "
101+
"it was initialized."
50102
msgstr ""
51103

52104
msgid ""
53-
"Note that this function is unsuitable if *typeobj* has :c:macro:"
54-
"`Py_TPFLAGS_HAVE_GC` set. For such objects, use :c:func:`PyObject_GC_New` "
55-
"instead."
105+
"This macro does not construct a fully initialized object of the given type; "
106+
"it merely allocates memory and prepares it for further initialization by :c:"
107+
"member:`~PyTypeObject.tp_init`. To construct a fully initialized object, "
108+
"call *typeobj* instead. For example::"
109+
msgstr ""
110+
111+
msgid "PyObject *foo = PyObject_CallNoArgs((PyObject *)&PyFoo_Type);"
112+
msgstr ""
113+
114+
msgid ":c:func:`PyObject_Free`"
115+
msgstr ":c:func:`PyObject_Free`"
116+
117+
msgid ":c:macro:`PyObject_GC_New`"
118+
msgstr ""
119+
120+
msgid ":c:func:`PyType_GenericAlloc`"
121+
msgstr ""
122+
123+
msgid ":c:member:`~PyTypeObject.tp_alloc`"
124+
msgstr ":c:member:`~PyTypeObject.tp_alloc`"
125+
126+
msgid "Like :c:macro:`PyObject_New` except:"
56127
msgstr ""
57128

58129
msgid ""
59-
"Allocate a new Python object using the C structure type *TYPE* and the "
60-
"Python type object *typeobj* (``PyTypeObject*``). Fields not defined by the "
61-
"Python object header are not initialized. The allocated memory allows for "
62-
"the *TYPE* structure plus *size* (``Py_ssize_t``) fields of the size given "
63-
"by the :c:member:`~PyTypeObject.tp_itemsize` field of *typeobj*. This is "
64-
"useful for implementing objects like tuples, which are able to determine "
65-
"their size at construction time. Embedding the array of fields into the "
66-
"same allocation decreases the number of allocations, improving the memory "
67-
"management efficiency."
130+
"It allocates enough memory for the *TYPE* structure plus *size* "
131+
"(``Py_ssize_t``) fields of the size given by the :c:member:`~PyTypeObject."
132+
"tp_itemsize` field of *typeobj*."
133+
msgstr ""
134+
135+
msgid "The memory is initialized like :c:func:`PyObject_InitVar`."
136+
msgstr ""
137+
138+
msgid ""
139+
"This is useful for implementing objects like tuples, which are able to "
140+
"determine their size at construction time. Embedding the array of fields "
141+
"into the same allocation decreases the number of allocations, improving the "
142+
"memory management efficiency."
143+
msgstr ""
144+
145+
msgid ""
146+
"This cannot be used for objects with :c:macro:`Py_TPFLAGS_HAVE_GC` set in :c:"
147+
"member:`~PyTypeObject.tp_flags`; use :c:macro:`PyObject_GC_NewVar` instead."
148+
msgstr ""
149+
150+
msgid ""
151+
"Memory allocated by this function must be freed with :c:func:`PyObject_Free` "
152+
"(usually called via the object's :c:member:`~PyTypeObject.tp_free` slot)."
68153
msgstr ""
69154

70155
msgid ""
71-
"Note that this function is unsuitable if *typeobj* has :c:macro:"
72-
"`Py_TPFLAGS_HAVE_GC` set. For such objects, use :c:func:`PyObject_GC_NewVar` "
73-
"instead."
156+
"PyObject *list_instance = PyObject_CallNoArgs((PyObject *)&PyList_Type);"
157+
msgstr ""
158+
159+
msgid ":c:macro:`PyObject_GC_NewVar`"
74160
msgstr ""
75161

76162
msgid "Same as :c:func:`PyObject_Free`."

‎c-api/buffer.po‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
# SOME DESCRIPTIVE TITLE.
2-
# Copyright (C) 2001-2025, Python Software Foundation
2+
# Copyright (C) 2001 Python Software Foundation
33
# This file is distributed under the same license as the Python package.
44
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
55
#
@@ -11,9 +11,9 @@
1111
#, fuzzy
1212
msgid ""
1313
msgstr ""
14-
"Project-Id-Version: Python 3.13\n"
14+
"Project-Id-Version: Python 3.14\n"
1515
"Report-Msgid-Bugs-To: \n"
16-
"POT-Creation-Date: 2025-05-02 14:19+0000\n"
16+
"POT-Creation-Date: 2025-05-16 14:19+0000\n"
1717
"PO-Revision-Date: 2021-06-28 00:47+0000\n"
1818
"Last-Translator: Stan Ulbrych, 2025\n"
1919
"Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n"

‎c-api/gcsupport.po‎

Lines changed: 67 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -4,16 +4,16 @@
44
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
55
#
66
# Translators:
7-
# Stan Ulbrych, 2024
7+
# Stan Ulbrych, 2025
88
#
99
#, fuzzy
1010
msgid ""
1111
msgstr ""
1212
"Project-Id-Version: Python 3.14\n"
1313
"Report-Msgid-Bugs-To: \n"
14-
"POT-Creation-Date: 2025-05-08 02:53-0300\n"
14+
"POT-Creation-Date: 2025-05-23 14:20+0000\n"
1515
"PO-Revision-Date: 2021-06-28 00:48+0000\n"
16-
"Last-Translator: Stan Ulbrych, 2024\n"
16+
"Last-Translator: Stan Ulbrych, 2025\n"
1717
"Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n"
1818
"MIME-Version: 1.0\n"
1919
"Content-Type: text/plain; charset=UTF-8\n"
@@ -100,11 +100,42 @@ msgid ""
100100
"macro:`Py_TPFLAGS_HAVE_GC` flag set."
101101
msgstr ""
102102

103+
msgid ""
104+
"Do not call this directly to allocate memory for an object; call the type's :"
105+
"c:member:`~PyTypeObject.tp_alloc` slot instead."
106+
msgstr ""
107+
108+
msgid ""
109+
"When populating a type's :c:member:`~PyTypeObject.tp_alloc` slot, :c:func:"
110+
"`PyType_GenericAlloc` is preferred over a custom function that simply calls "
111+
"this macro."
112+
msgstr ""
113+
114+
msgid ""
115+
"Memory allocated by this macro must be freed with :c:func:`PyObject_GC_Del` "
116+
"(usually called via the object's :c:member:`~PyTypeObject.tp_free` slot)."
117+
msgstr ""
118+
119+
msgid ":c:func:`PyObject_GC_Del`"
120+
msgstr ""
121+
122+
msgid ":c:macro:`PyObject_New`"
123+
msgstr ""
124+
125+
msgid ":c:func:`PyType_GenericAlloc`"
126+
msgstr ""
127+
128+
msgid ":c:member:`~PyTypeObject.tp_alloc`"
129+
msgstr ":c:member:`~PyTypeObject.tp_alloc`"
130+
103131
msgid ""
104132
"Analogous to :c:macro:`PyObject_NewVar` but for container objects with the :"
105133
"c:macro:`Py_TPFLAGS_HAVE_GC` flag set."
106134
msgstr ""
107135

136+
msgid ":c:macro:`PyObject_NewVar`"
137+
msgstr ""
138+
108139
msgid ""
109140
"Analogous to :c:macro:`PyObject_GC_New` but allocates *extra_size* bytes at "
110141
"the end of the object (at offset :c:member:`~PyTypeObject.tp_basicsize`). "
@@ -117,6 +148,12 @@ msgid ""
117148
"managed by Python."
118149
msgstr ""
119150

151+
msgid ""
152+
"Memory allocated by this function must be freed with :c:func:"
153+
"`PyObject_GC_Del` (usually called via the object's :c:member:`~PyTypeObject."
154+
"tp_free` slot)."
155+
msgstr ""
156+
120157
msgid ""
121158
"The function is marked as unstable because the final mechanism for reserving "
122159
"extra data after an instance is not yet decided. For allocating a variable "
@@ -174,6 +211,29 @@ msgid ""
174211
"c:macro:`PyObject_GC_NewVar`."
175212
msgstr ""
176213

214+
msgid ""
215+
"Do not call this directly to free an object's memory; call the type's :c:"
216+
"member:`~PyTypeObject.tp_free` slot instead."
217+
msgstr ""
218+
219+
msgid ""
220+
"Do not use this for memory allocated by :c:macro:`PyObject_New`, :c:macro:"
221+
"`PyObject_NewVar`, or related allocation functions; use :c:func:"
222+
"`PyObject_Free` instead."
223+
msgstr ""
224+
225+
msgid ":c:func:`PyObject_Free` is the non-GC equivalent of this function."
226+
msgstr ""
227+
228+
msgid ":c:macro:`PyObject_GC_New`"
229+
msgstr ""
230+
231+
msgid ":c:macro:`PyObject_GC_NewVar`"
232+
msgstr ""
233+
234+
msgid ":c:member:`~PyTypeObject.tp_free`"
235+
msgstr ":c:member:`~PyTypeObject.tp_free`"
236+
177237
msgid ""
178238
"Remove the object *op* from the set of container objects tracked by the "
179239
"collector. Note that :c:func:`PyObject_GC_Track` can be called again on "
@@ -224,9 +284,10 @@ msgid ""
224284
msgstr ""
225285

226286
msgid ""
227-
"If *o* is not ``NULL``, call the *visit* callback, with arguments *o* and "
228-
"*arg*. If *visit* returns a non-zero value, then return it. Using this "
229-
"macro, :c:member:`~PyTypeObject.tp_traverse` handlers look like::"
287+
"If the :c:expr:`PyObject *` *o* is not ``NULL``, call the *visit* callback, "
288+
"with arguments *o* and *arg*. If *visit* returns a non-zero value, then "
289+
"return it. Using this macro, :c:member:`~PyTypeObject.tp_traverse` handlers "
290+
"look like::"
230291
msgstr ""
231292

232293
msgid ""

0 commit comments

Comments
 (0)