11# SOME DESCRIPTIVE TITLE.
2- # Copyright (C) 2001-2023 , Python Software Foundation
2+ # Copyright (C) 2001-2024 , Python Software Foundation
33# This file is distributed under the same license as the Python package.
44# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
55#
66# Translators:
7- # Transifex Bot < >, 2023
7+ # Maciej Olko <[email protected] >, 2024 88#
99#, fuzzy
1010msgid ""
1111msgstr ""
12- "Project-Id-Version : Python 3.11 \n "
12+ "Project-Id-Version : Python 3.13 \n "
1313"Report-Msgid-Bugs-To : \n "
14- "POT-Creation-Date : 2023-05-19 14:13 +0000\n "
14+ "POT-Creation-Date : 2024-08-16 14:15 +0000\n "
1515"PO-Revision-Date : 2021-06-28 00:50+0000\n "
16- "Last-Translator : Transifex Bot < >, 2023 \n "
16+ "
Last-Translator :
Maciej Olko <[email protected] >, 2024 \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 "
@@ -27,47 +27,81 @@ msgid "C API Stability"
2727msgstr ""
2828
2929msgid ""
30- "Python's C API is covered by the Backwards Compatibility Policy, :pep:`387`. "
31- "While the C API will change with every minor release (e.g. from 3.9 to "
32- "3.10), most changes will be source-compatible, typically by only adding new "
33- "API. Changing existing API or removing API is only done after a deprecation "
34- "period or to fix serious issues."
30+ "Unless documented otherwise, Python's C API is covered by the Backwards "
31+ "Compatibility Policy, :pep:`387`. Most changes to it are source-compatible "
32+ "(typically by only adding new API). Changing existing API or removing API is "
33+ "only done after a deprecation period or to fix serious issues."
3534msgstr ""
3635
3736msgid ""
3837"CPython's Application Binary Interface (ABI) is forward- and backwards-"
3938"compatible across a minor release (if these are compiled the same way; see :"
4039"ref:`stable-abi-platform` below). So, code compiled for Python 3.10.0 will "
4140"work on 3.10.8 and vice versa, but will need to be compiled separately for "
42- "3.9.x and 3.10.x."
41+ "3.9.x and 3.11.x."
42+ msgstr ""
43+
44+ msgid "There are two tiers of C API with different stability expectations:"
45+ msgstr ""
46+
47+ msgid ""
48+ ":ref:`Unstable API <unstable-c-api>`, may change in minor versions without a "
49+ "deprecation period. It is marked by the ``PyUnstable`` prefix in names."
50+ msgstr ""
51+
52+ msgid ""
53+ ":ref:`Limited API <limited-c-api>`, is compatible across several minor "
54+ "releases. When :c:macro:`Py_LIMITED_API` is defined, only this subset is "
55+ "exposed from ``Python.h``."
56+ msgstr ""
57+
58+ msgid "These are discussed in more detail below."
4359msgstr ""
4460
4561msgid ""
4662"Names prefixed by an underscore, such as ``_Py_InternalState``, are private "
47- "API that can change without notice even in patch releases."
63+ "API that can change without notice even in patch releases. If you need to "
64+ "use this API, consider reaching out to `CPython developers <https://discuss."
65+ "python.org/c/core-dev/c-api/30>`_ to discuss adding public API for your use "
66+ "case."
4867msgstr ""
4968
50- msgid "Stable Application Binary Interface "
69+ msgid "Unstable C API "
5170msgstr ""
5271
5372msgid ""
54- "Python 3.2 introduced the *Limited API*, a subset of Python's C API. "
55- "Extensions that only use the Limited API can be compiled once and work with "
56- "multiple versions of Python. Contents of the Limited API are :ref:`listed "
57- "below <stable-abi-list>` ."
73+ "Any API named with the ``PyUnstable`` prefix exposes CPython implementation "
74+ "details, and may change in every minor release (e.g. from 3.9 to 3.10) "
75+ "without any deprecation warnings. However, it will not change in a bugfix "
76+ "release (e.g. from 3.10.0 to 3.10.1) ."
5877msgstr ""
5978
6079msgid ""
61- "To enable this, Python provides a *Stable ABI*: a set of symbols that will "
62- "remain compatible across Python 3.x versions. The Stable ABI contains "
63- "symbols exposed in the Limited API, but also other ones – for example, "
64- "functions necessary to support older versions of the Limited API."
80+ "It is generally intended for specialized, low-level tools like debuggers."
81+ msgstr ""
82+
83+ msgid ""
84+ "Projects that use this API are expected to follow CPython development and "
85+ "spend extra effort adjusting to changes."
86+ msgstr ""
87+
88+ msgid "Stable Application Binary Interface"
6589msgstr ""
6690
6791msgid ""
68- "( For simplicity, this document talks about *extensions*, but the Limited API "
92+ "For simplicity, this document talks about *extensions*, but the Limited API "
6993"and Stable ABI work the same way for all uses of the API – for example, "
70- "embedding Python.)"
94+ "embedding Python."
95+ msgstr ""
96+
97+ msgid "Limited C API"
98+ msgstr ""
99+
100+ msgid ""
101+ "Python 3.2 introduced the *Limited API*, a subset of Python's C API. "
102+ "Extensions that only use the Limited API can be compiled once and work with "
103+ "multiple versions of Python. Contents of the Limited API are :ref:`listed "
104+ "below <limited-api-list>`."
71105msgstr ""
72106
73107msgid ""
@@ -76,7 +110,7 @@ msgid ""
76110msgstr ""
77111
78112msgid ""
79- "Define ``Py_LIMITED_API`` to the value of :c:data :`PY_VERSION_HEX` "
113+ "Define ``Py_LIMITED_API`` to the value of :c:macro :`PY_VERSION_HEX` "
80114"corresponding to the lowest Python version your extension supports. The "
81115"extension will work without recompilation with all Python 3 releases from "
82116"the specified one onward, and can use Limited API introduced up to that "
@@ -94,6 +128,20 @@ msgid ""
94128"``0x03020000`` (Python 3.2, the version that introduced Limited API)."
95129msgstr ""
96130
131+ msgid "Stable ABI"
132+ msgstr "stabilnego ABI"
133+
134+ msgid ""
135+ "To enable this, Python provides a *Stable ABI*: a set of symbols that will "
136+ "remain compatible across Python 3.x versions."
137+ msgstr ""
138+
139+ msgid ""
140+ "The Stable ABI contains symbols exposed in the :ref:`Limited API <limited-c-"
141+ "api>`, but also other ones – for example, functions necessary to support "
142+ "older versions of the Limited API."
143+ msgstr ""
144+
97145msgid ""
98146"On Windows, extensions that use the Stable ABI should be linked against "
99147"``python3.dll`` rather than a version-specific library such as ``python39."
@@ -149,9 +197,9 @@ msgstr ""
149197
150198msgid ""
151199"Note that compiling with ``Py_LIMITED_API`` is *not* a complete guarantee "
152- "that code conforms to the Limited API or the Stable ABI. ``Py_LIMITED_API`` "
153- "only covers definitions, but an API also includes other issues, such as "
154- "expected semantics."
200+ "that code conforms to the :ref:` Limited API <limited-c-api>` or the :ref: "
201+ "`Stable ABI <stable-abi>`. ``Py_LIMITED_API`` only covers definitions, but "
202+ "an API also includes other issues, such as expected semantics."
155203msgstr ""
156204
157205msgid ""
@@ -193,9 +241,9 @@ msgstr ""
193241
194242msgid ""
195243"ABI stability depends not only on Python, but also on the compiler used, "
196- "lower-level libraries and compiler options. For the purposes of the Stable "
197- "ABI, these details define a “platform”. They usually depend on the OS type "
198- "and processor architecture"
244+ "lower-level libraries and compiler options. For the purposes of the :ref: "
245+ "`Stable ABI <stable-abi>` , these details define a “platform”. They usually "
246+ "depend on the OS type and processor architecture"
199247msgstr ""
200248
201249msgid ""
@@ -208,5 +256,10 @@ msgstr ""
208256msgid "Contents of Limited API"
209257msgstr ""
210258
211- msgid "Currently, the Limited API includes the following items:"
259+ msgid ""
260+ "Currently, the :ref:`Limited API <limited-c-api>` includes the following "
261+ "items:"
262+ msgstr ""
263+
264+ msgid "PyUnstable"
212265msgstr ""
0 commit comments