| FazBrowse GitHub Viewer | Trending | | Home |
| Tools: [Download Repo ZIP] [Original HTTPS Page] |
1 parent a42adc9 commit ed4716e
4 files changed
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
@@ -16,7 +16,7 @@ f''' | |
| 18 | 18 |  | |
| 19 | -  | ||
| 19 | +  | ||
| 20 | 20 |  | |
| 21 | 21 | <!-- [[[end]]] --> | |
| 22 | 22 | ||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
@@ -1,19 +1,19 @@ | |||
| 1 | 1 | # SOME DESCRIPTIVE TITLE. | |
| 2 | - # Copyright (C) 2001-2023, Python Software Foundation | ||
| 2 | + # Copyright (C) 2001-2024, Python Software Foundation | ||
| 3 | 3 | # This file is distributed under the same license as the Python package. | |
| 4 | 4 | # FIRST AUTHOR <EMAIL@ADDRESS>, YEAR. | |
| 5 | 5 | # | |
| 6 | 6 | # Translators: | |
| 7 | - # Transifex Bot <>, 2023 | ||
| 7 | + # Maciej Olko <maciej.olko@gmail.com>, 2024 | ||
| 8 | 8 | # | |
| 9 | 9 | #, fuzzy | |
| 10 | 10 | msgid "" | |
| 11 | 11 | msgstr "" | |
| 12 | - "Project-Id-Version: Python 3.11\n" | ||
| 12 | + "Project-Id-Version: Python 3.13\n" | ||
| 13 | 13 | "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" | ||
| 15 | 15 | "PO-Revision-Date: 2021-06-28 00:50+0000\n" | |
| 16 | - "Last-Translator: Transifex Bot <>, 2023\n" | ||
| 16 | + "Last-Translator: Maciej Olko <maciej.olko@gmail.com>, 2024\n" | ||
| 17 | 17 | "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" | |
| 18 | 18 | "MIME-Version: 1.0\n" | |
| 19 | 19 | "Content-Type: text/plain; charset=UTF-8\n" | |
@@ -27,47 +27,81 @@ msgid "C API Stability" | |||
| 27 | 27 | msgstr "" | |
| 28 | 28 | ||
| 29 | 29 | msgid "" | |
| 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." | ||
| 35 | 34 | msgstr "" | |
| 36 | 35 | ||
| 37 | 36 | msgid "" | |
| 38 | 37 | "CPython's Application Binary Interface (ABI) is forward- and backwards-" | |
| 39 | 38 | "compatible across a minor release (if these are compiled the same way; see :" | |
| 40 | 39 | "ref:`stable-abi-platform` below). So, code compiled for Python 3.10.0 will " | |
| 41 | 40 | "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." | ||
| 43 | 59 | msgstr "" | |
| 44 | 60 | ||
| 45 | 61 | msgid "" | |
| 46 | 62 | "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." | ||
| 48 | 67 | msgstr "" | |
| 49 | 68 | ||
| 50 | - msgid "Stable Application Binary Interface" | ||
| 69 | + msgid "Unstable C API" | ||
| 51 | 70 | msgstr "" | |
| 52 | 71 | ||
| 53 | 72 | msgid "" | |
| 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)." | ||
| 58 | 77 | msgstr "" | |
| 59 | 78 | ||
| 60 | 79 | msgid "" | |
| 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" | ||
| 65 | 89 | msgstr "" | |
| 66 | 90 | ||
| 67 | 91 | msgid "" | |
| 68 | - "(For simplicity, this document talks about *extensions*, but the Limited API " | ||
| 92 | + "For simplicity, this document talks about *extensions*, but the Limited API " | ||
| 69 | 93 | "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>`." | ||
| 71 | 105 | msgstr "" | |
| 72 | 106 | ||
| 73 | 107 | msgid "" | |
@@ -76,7 +110,7 @@ msgid "" | |||
| 76 | 110 | msgstr "" | |
| 77 | 111 | ||
| 78 | 112 | msgid "" | |
| 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` " | ||
| 80 | 114 | "corresponding to the lowest Python version your extension supports. The " | |
| 81 | 115 | "extension will work without recompilation with all Python 3 releases from " | |
| 82 | 116 | "the specified one onward, and can use Limited API introduced up to that " | |
@@ -94,6 +128,20 @@ msgid "" | |||
| 94 | 128 | "``0x03020000`` (Python 3.2, the version that introduced Limited API)." | |
| 95 | 129 | msgstr "" | |
| 96 | 130 | ||
| 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 | + | ||
| 97 | 145 | msgid "" | |
| 98 | 146 | "On Windows, extensions that use the Stable ABI should be linked against " | |
| 99 | 147 | "``python3.dll`` rather than a version-specific library such as ``python39." | |
@@ -149,9 +197,9 @@ msgstr "" | |||
| 149 | 197 | ||
| 150 | 198 | msgid "" | |
| 151 | 199 | "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." | ||
| 155 | 203 | msgstr "" | |
| 156 | 204 | ||
| 157 | 205 | msgid "" | |
@@ -193,9 +241,9 @@ msgstr "" | |||
| 193 | 241 | ||
| 194 | 242 | msgid "" | |
| 195 | 243 | "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" | ||
| 199 | 247 | msgstr "" | |
| 200 | 248 | ||
| 201 | 249 | msgid "" | |
@@ -208,5 +256,10 @@ msgstr "" | |||
| 208 | 256 | msgid "Contents of Limited API" | |
| 209 | 257 | msgstr "" | |
| 210 | 258 | ||
| 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" | ||
| 212 | 265 | msgstr "" | |
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
@@ -4,7 +4,7 @@ | |||
| 4 | 4 | # FIRST AUTHOR <EMAIL@ADDRESS>, YEAR. | |
| 5 | 5 | # | |
| 6 | 6 | # Translators: | |
| 7 | - # Maciej Olko <maciej.olko@gmail.com>, 2021 | ||
| 7 | + # Maciej Olko <maciej.olko@gmail.com>, 2024 | ||
| 8 | 8 | # | |
| 9 | 9 | #, fuzzy | |
| 10 | 10 | msgid "" | |
@@ -13,7 +13,7 @@ msgstr "" | |||
| 13 | 13 | "Report-Msgid-Bugs-To: \n" | |
| 14 | 14 | "POT-Creation-Date: 2024-08-16 14:15+0000\n" | |
| 15 | 15 | "PO-Revision-Date: 2021-06-28 01:07+0000\n" | |
| 16 | - "Last-Translator: Maciej Olko <maciej.olko@gmail.com>, 2021\n" | ||
| 16 | + "Last-Translator: Maciej Olko <maciej.olko@gmail.com>, 2024\n" | ||
| 17 | 17 | "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" | |
| 18 | 18 | "MIME-Version: 1.0\n" | |
| 19 | 19 | "Content-Type: text/plain; charset=UTF-8\n" | |
@@ -262,7 +262,7 @@ msgid "Parsing invalid HTML (e.g. unquoted attributes) also works::" | |||
| 262 | 262 | msgstr "" | |
| 263 | 263 | ||
| 264 | 264 | msgid "HTML" | |
| 265 | - msgstr "" | ||
| 265 | + msgstr "HTML" | ||
| 266 | 266 | ||
| 267 | 267 | msgid "XHTML" | |
| 268 | 268 | msgstr "" | |
| Back | FazBrowse Home | New Git URL |
0 commit comments